From 7e3a67a02efd3b6aabfdc4832a0b5e2f7f0c366e Mon Sep 17 00:00:00 2001
From: Sam <samuv.eth@gmail.com>
Date: Wed, 2 Sep 2026 17:04:32 +0700
Subject: [PATCH] the unit frames are the reference's own, and the water has
 motes in it
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- the player, party, target and pet frames are the reference's own files (`BuffFrame`, `UnitFrame`, `CombatFeedback`, `PlayerFrame`, `PartyFrame`, `TargetFrame`, `PetFrame`, in the reference's toc order) — our 2741-line `UnitFrames.xml` and our `PartyFrame.xml` are deleted; four engine verbs built for them (`PartialPlayTime`, `NoPlayTime`, `UnitPlayerControlled`, `UnitIsCivilian`, each answering 1/nil), the whole-UI load bracketed in the counted sound-suppression scope `0x48fbf0` self-brackets (the reference fires a `PlaySound` during load and throws it away), and `GetBillingTimeRested` read off `SMSG_AUTH_RESPONSE`'s third billing field rather than hardcoded; the differences the stock files bring are pinned rather than papered — `PlayerFrame` never hides, an unresolved name is BLANK not "Unknown", the target frame has no numerals at all (a bar hover pops the unit tooltip instead)
- what the swap surfaced, each a hard break under the stock files: `UnitBuff`/`UnitDebuff` returned the Classic Era ten-value tuple, name first, where 1.12 returns two and three values TEXTURE first (`0x519500`/`0x5198f0`) — a raise twice per `UNIT_AURA` on any debuffed target, and all 184 corpus call sites bind the 1.12 shape; the power events are named per resource (`UNIT_MANA`/`RAGE`/`FOCUS`/`ENERGY`/`HAPPINESS` and their MAX twins) and we fired the Era pair, so no mana, rage or energy bar could live-update; `SetRaidTarget` is the engine verb and `SetRaidTargetIcon` the FrameXML toggle wrapper — we had registered the wrapper's name on the engine's body, so every raid mark in the unit popup raised
- the underwater drift cloud: the reference draws a fixed 4000-mote field whenever the camera eye is inside a liquid — not a particle system, nothing spawns, ages or dies; a population scattered once into a 30 yd camera-relative cube, advected by the camera's own motion plus a gust and wrapped, so the field stands still in the world; benilla had the murk and nothing in it; a dry frame commits no draw, and the submerged one is bounded by the reference's own 666-quad cap (633–644 of 4000 measured live, which is the expected survivor count of a uniform cube through the 90° cone — an independent check on population, distribution and cone at once)

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
---
 crates/benilla-app/assets/ui/ActionBar.xml    |    6 +-
 crates/benilla-app/assets/ui/CombatText.xml   |   19 +-
 crates/benilla-app/assets/ui/OptionsFrame.xml |   13 +
 crates/benilla-app/assets/ui/PartyFrame.xml   |  360 ---
 crates/benilla-app/assets/ui/UIParent.xml     |    7 +
 crates/benilla-app/assets/ui/UnitFrames.xml   | 2741 -----------------
 crates/benilla-app/assets/ui/benilla.toc      |   94 +-
 crates/benilla-app/src/addon_harness/mod.rs   |   15 +-
 crates/benilla-app/src/char_select/mod.rs     |    8 +-
 crates/benilla-app/src/net.rs                 |    7 +-
 crates/benilla-app/src/net/apply.rs           |    2 +
 crates/benilla-app/src/net/apply/session.rs   |    5 +-
 crates/benilla-app/src/net/io.rs              |    2 +
 .../src/ui_script/character_tests.rs          |    1 +
 .../src/ui_script/combo_frame_tests.rs        |   15 +-
 .../src/ui_script/frame_flag_gate.rs          |   19 +-
 .../src/ui_script/game_menu_tests.rs          |   12 +-
 .../src/ui_script/inspect_tests.rs            |    1 +
 .../src/ui_script/instance_tests.rs           |   10 +-
 crates/benilla-app/src/ui_script/lifecycle.rs |    1 +
 crates/benilla-app/src/ui_script/manifest.rs  |   12 +
 crates/benilla-app/src/ui_script/mod.rs       |    6 +-
 .../src/ui_script/options_tests.rs            |   16 +-
 .../src/ui_script/pet_frame_tests.rs          |  104 +-
 .../src/ui_script/pet_paperdoll_tests.rs      |    1 +
 .../benilla-app/src/ui_script/quiver_tests.rs |    1 +
 .../benilla-app/src/ui_script/reference_ui.rs |   33 +-
 .../src/ui_script/shipped_xml_tests.rs        |   46 +-
 .../src/ui_script/target_aura_tests.rs        |   42 +-
 crates/benilla-app/src/ui_script/test_ui.rs   |   38 +-
 .../src/ui_script/tooltip_anchor_tests.rs     |   57 +-
 .../src/ui_script/tot_frame_tests.rs          |  212 +-
 .../src/ui_script/unit_frame_tests.rs         |  366 ++-
 .../src/ui_script/unit_popup_tests.rs         |   64 +-
 crates/benilla-app/src/ui_unit.rs             |   67 +-
 crates/benilla-protocol/src/events.rs         |   10 +-
 .../benilla-protocol/src/messages/packet.rs   |    9 +
 crates/benilla-protocol/src/messages/parse.rs |    9 +-
 crates/benilla-protocol/src/world/session.rs  |   29 +-
 crates/benilla-ui/src/script/aura/mod.rs      |  158 +-
 crates/benilla-ui/src/script/mod.rs           |   16 +-
 crates/benilla-ui/src/script/model.rs         |   41 +
 crates/benilla-ui/src/script/party.rs         |   15 +-
 crates/benilla-ui/src/script/sound.rs         |   11 +-
 crates/benilla-ui/src/script/unit/bindings.rs |   84 +
 crates/benilla-ui/src/script/unit/mod.rs      |   57 +-
 crates/benilla-world/src/liquid/drift.rs      |  930 ++++++
 crates/benilla-world/src/liquid/mod.rs        |    8 +
 crates/benilla-world/src/particles/emit.rs    |    2 +-
 crates/benilla-world/src/particles/render.rs  |    1 +
 crates/benilla-world/src/sky_order.rs         |   21 +
 51 files changed, 2337 insertions(+), 3467 deletions(-)
 delete mode 100644 crates/benilla-app/assets/ui/PartyFrame.xml
 delete mode 100644 crates/benilla-app/assets/ui/UnitFrames.xml
 create mode 100644 crates/benilla-world/src/liquid/drift.rs

diff --git a/crates/benilla-app/assets/ui/ActionBar.xml b/crates/benilla-app/assets/ui/ActionBar.xml
index 55a89b04..5bccfd6a 100644
--- a/crates/benilla-app/assets/ui/ActionBar.xml
+++ b/crates/benilla-app/assets/ui/ActionBar.xml
@@ -100,9 +100,11 @@
         BOTTOMRIGHT_ACTIONBAR_PAGE = 5
         BOTTOMLEFT_ACTIONBAR_PAGE = 6
 
-        -- Ref ActionButton.lua:4 / UIParent.lua: the flash blink period and the range-check cadence.
+        -- Ref ActionButton.lua:4: the flash blink period. Its neighbour `TOOLTIP_UPDATE_TIME`
+        -- (the range-check cadence this file's `rangeTimer` reads) moved to UIParent.xml, which is
+        -- the reference's own home for it — `UIParent.lua:1`, and the stock `BuffFrame.lua` reads
+        -- it as well.
         ATTACK_BUTTON_FLASH_TIME = 0.4
-        TOOLTIP_UPDATE_TIME = 0.2
 
         -- "Lock ActionBars" (ref UIOptionsFrame.lua:102-103 — uvar LOCK_ACTIONBAR, default "0").
         -- The reference declares it in its options window; ours lives with the bar it locks, which
diff --git a/crates/benilla-app/assets/ui/CombatText.xml b/crates/benilla-app/assets/ui/CombatText.xml
index d635b0a0..76ab35d8 100644
--- a/crates/benilla-app/assets/ui/CombatText.xml
+++ b/crates/benilla-app/assets/ui/CombatText.xml
@@ -19,8 +19,10 @@
           strings; region templates are outside the v1 loader's object model (BuffFrame.xml has
           the precedent note), so the 20 instances inherit the CombatTextFont Font object and
           carry the template's anchor directly.
-        - UNIT_MANA → UNIT_POWER_UPDATE + the Era Unit* API (our event surface, decision 0068);
-          same low-mana law. PLAYER_COMBO_POINTS rides the combo wire (0869); its arm reads
+        - UNIT_MANA, the spec's own event. This used to read UNIT_POWER_UPDATE + the Era Unit* API
+          (0068's surface); 1819 retired that pair — 1.12 names the resource in the event, and the
+          Era spelling was a deviation this file's own header already flagged. Same low-mana law,
+          and now the handler is not woken by rage or energy at all. PLAYER_COMBO_POINTS rides the combo wire (0869); its arm reads
           `GetComboPoints()`, so it is rogue/druid-only and per-target for free — the binding
           gates, not this file (0875).
         - Lua 5.0 `for k,v in t` iteration becomes explicit index loops (5.1 VM), backwards
@@ -284,10 +286,11 @@
                 if not messageType then
                     return
                 end
-            elseif event == "UNIT_POWER_UPDATE" then
-                -- Spec: UNIT_MANA + UnitMana/UnitManaMax (header deviation — the Era surface).
-                -- Power type 0 is mana; the same event also carries rage, focus and energy, none
-                -- of which has a low warning.
+            elseif event == "UNIT_MANA" then
+                -- The powerType == 0 guard still earns its place: `power_token` reports an UNKNOWN
+                -- power type as MANA (its descriptor default), so this event can arrive for a unit
+                -- whose track is not really mana. Rage, focus and energy now have their own event
+                -- names and never reach here at all (1819).
                 local mana = UnitMana("player")
                 local powerType = UnitPowerType("player")
                 if arg1 == "player" then
@@ -567,7 +570,7 @@
             if SHOW_COMBAT_TEXT == "0" then
                 CombatText:UnregisterEvent("COMBAT_TEXT_UPDATE")
                 CombatText:UnregisterEvent("UNIT_HEALTH")
-                CombatText:UnregisterEvent("UNIT_POWER_UPDATE")
+                CombatText:UnregisterEvent("UNIT_MANA")
                 CombatText:UnregisterEvent("PLAYER_COMBO_POINTS")
                 CombatText:UnregisterEvent("PLAYER_REGEN_DISABLED")
                 CombatText:UnregisterEvent("PLAYER_REGEN_ENABLED")
@@ -575,7 +578,7 @@
             else
                 CombatText:RegisterEvent("COMBAT_TEXT_UPDATE")
                 CombatText:RegisterEvent("UNIT_HEALTH")
-                CombatText:RegisterEvent("UNIT_POWER_UPDATE")
+                CombatText:RegisterEvent("UNIT_MANA")
                 CombatText:RegisterEvent("PLAYER_COMBO_POINTS")
                 CombatText:RegisterEvent("PLAYER_REGEN_DISABLED")
                 CombatText:RegisterEvent("PLAYER_REGEN_ENABLED")
diff --git a/crates/benilla-app/assets/ui/OptionsFrame.xml b/crates/benilla-app/assets/ui/OptionsFrame.xml
index 8d43abb7..48e4a6d9 100644
--- a/crates/benilla-app/assets/ui/OptionsFrame.xml
+++ b/crates/benilla-app/assets/ui/OptionsFrame.xml
@@ -210,6 +210,19 @@
         SHOW_BUFF_DURATIONS = "0"
         RegisterForSave("SHOW_BUFF_DURATIONS")
 
+        -- The target-of-target pair, at the reference's own values and in the reference's own home
+        -- (`UIOptionsFrame.lua` l.116-119, where both sit in the uvar defaults block and both are
+        -- RegisterForSave'd). The switch ships OFF and the state ships "5".
+        --
+        -- These lived in our `UnitFrames.xml` file scope until the unit-frame kit went to the
+        -- chain — a squatter, and its own note said so. The reference declares them beside the
+        -- other party/unit uvars here, and `TargetFrame.lua:504` reads the switch at CALL time
+        -- (`TargetofTarget_Update`), so this file sitting far below the frames does not bind.
+        SHOW_TARGET_OF_TARGET = "0"
+        SHOW_TARGET_OF_TARGET_STATE = "5"
+        RegisterForSave("SHOW_TARGET_OF_TARGET")
+        RegisterForSave("SHOW_TARGET_OF_TARGET_STATE")
+
         -- The static category tree (era Game tab, Classic tocs), in list order. Keys are the row
         -- name suffixes; the visible label doubles as the page title (the era does the same —
         -- Settings.RegisterCategory names both from one string).
diff --git a/crates/benilla-app/assets/ui/PartyFrame.xml b/crates/benilla-app/assets/ui/PartyFrame.xml
deleted file mode 100644
index 56966fe2..00000000
--- a/crates/benilla-app/assets/ui/PartyFrame.xml
+++ /dev/null
@@ -1,360 +0,0 @@
-<Ui>
-    <!--
-        The party member frames + the group-invite popup (decision 0434 phase 3). Geometry, art
-        paths and behavior laws are MEASURED against the reference client's own FrameXML, extracted
-        through the full MPQ patch chain (decision 0246; survey 2026-07-17):
-        PartyFrame.xml, PartyFrameTemplates.xml, PartyMemberFrame.lua, StaticPopup.lua ("PARTY_INVITE"),
-        UIParent.lua (the PARTY_INVITE_REQUEST wiring) — the code below is our own. Data flow is
-        ours too: the app feeds
-        party1..party4 unit snapshots + the PartyState roster (crates/benilla/src/ui_party.rs) and
-        fires the PARTY_* events; the popup's Accept/Decline queue PartyRequests the app drains.
-
-        THE CASCADE. The ref anchors frames 2-4 to the PREVIOUS frame's PetFrame bottom-left at
-        (-23,-10) — spacing rides the pet frame, which sits at (23,-27) when hidden (26 tall), so
-        the no-pet stride is TOPLEFT->BOTTOMLEFT (0,-10). Pet frames land in phase 4; until then
-        the cascade uses that no-pet stride directly, which is byte-identical to the ref's layout
-        for petless parties (the only kind phase 3 renders).
-
-        DEVIATIONS / DEFERRED (phase 4+, decision 0434):
-        - Pet frames, the 4 debuff buttons (48,-32 +2px chain), the 16/8 buff hover panel, and the
-          dispellable-debuff Status ring: they need the party aura/pet feed (phase 4).
-        (The PVP icon landed with decision 0646 — UnitFactionGroup exists now.)
-        - HIDE_PARTY_INTERFACE (hide-in-raid uvar): waits for the raid UI slice.
-        - Portrait: our high-res model bake (decision 0105), same as every unit frame.
-        - The ref's low-health portrait pulse flips alpha 127/255<->255/255 on 0.5 s half-cycles
-          (PartyMemberFrame.lua's sign-flip counter); transcribed as the same triangle wave.
-
-        DOUBLE-DECLINE, KEPT: the ref's popup calls DeclineGroup() in OnCancel AND again in OnHide
-        (only OnAccept sets the inviteAccepted guard), so a clicked Decline sends two
-        CMSG_GROUP_DECLINE. vmangos silently ignores the second (no pending invite -> early
-        return). Matched rather than "fixed" - the wire tolerates it and the guard's
-        real job is the timeout/override/escape paths.
-    -->
-    <Script><![CDATA[
-        -- MAX_RAID_MEMBERS / NUM_RAID_GROUPS / MEMBERS_PER_RAID_GROUP moved out. They were
-        -- declared here on the stated grounds that "we ship no RaidFrame.xml", which stopped being
-        -- true — RaidFrame.xml declares all three, which is the reference's own home for them
-        -- (RaidFrame.lua l.2-4). Nothing between the two manifest positions reads them at load.
-        -- The party's own bound (ref PartyMemberFrame.lua l.1) — four *other* members, so a full
-        -- party sweep that includes the player runs `1, MAX_PARTY_MEMBERS+1`, which is exactly how
-        -- GroupLootDropDown_Initialize walks the master-loot candidates (LootFrame.lua l.219).
-        -- Published for the same reason as its raid siblings: the addon corpus reads it.
-        MAX_PARTY_MEMBERS = 4
-
-        -- The PARTY_INVITE dialog and its PARTY_INVITE_REQUEST/_CANCEL driver MOVED OUT, to
-        -- UiPanels.xml — the reference's own homes for both (StaticPopup.lua l.526, UIParent.lua).
-        -- They were here only because this is where they were first needed; 1751 walked them back,
-        -- so this file is that much smaller when it follows them onto the chain.
-
-        -- ref PartyMemberFrame.lua's OnLoad: cache children, register, first paint.
-        function BenillaPartyFrame_OnLoad(frame)
-            local id = frame:GetID()
-            local name = frame:GetName()
-            local tf = name .. "TextureFrame"
-            frame.unit = "party" .. id
-            frame.portrait   = getglobal(name .. "Portrait")
-            frame.healthbar  = getglobal(name .. "HealthBar")
-            frame.manabar    = getglobal(name .. "ManaBar")
-            -- The recessed-bar look, the reference's own mechanism (ref-TargetFrame.lua l.32-34):
-            -- push the bars one frame level BELOW the art's TextureFrame. Frame level is the only
-            -- key term above the draw layer (decision 0884), so this is the only thing that can hold
-            -- the BACKGROUND party art over the ARTWORK bar fills. See the LAYERING note below.
-            local textureFrameLevel = getglobal(tf):GetFrameLevel()
-            frame.healthbar:SetFrameLevel(textureFrameLevel - 1)
-            frame.manabar:SetFrameLevel(textureFrameLevel - 1)
-            frame.nameText   = getglobal(tf .. "Name")
-            frame.leaderIcon = getglobal(tf .. "LeaderIcon")
-            frame.masterIcon = getglobal(tf .. "MasterIcon")
-            frame.disconnect = getglobal(tf .. "Disconnect")
-            frame.pvpIcon    = getglobal(tf .. "PVPIcon")
-            frame.flashTimer = 0
-            SetPortraitTexture(frame.portrait, frame.unit)
-            frame:RegisterEvent("PLAYER_ENTERING_WORLD")
-            frame:RegisterEvent("PARTY_MEMBERS_CHANGED")
-            frame:RegisterEvent("PARTY_LEADER_CHANGED")
-            frame:RegisterEvent("PARTY_LOOT_METHOD_CHANGED")
-            frame:RegisterEvent("UNIT_HEALTH")
-            frame:RegisterEvent("UNIT_MAXHEALTH")
-            frame:RegisterEvent("UNIT_POWER_UPDATE")
-            frame:RegisterEvent("UNIT_MAXPOWER")
-            frame:RegisterEvent("UNIT_DISPLAYPOWER")
-            frame:RegisterEvent("UNIT_NAME_UPDATE")
-            frame:RegisterEvent("UNIT_FACTION")
-            frame:EnableMouse(true)
-            BenillaPartyFrame_Update(frame)
-        end
-
-        function BenillaPartyFrame_OnEvent(frame)
-            -- UNIT_* events name their unit in arg1; other units' updates are not ours.
-            if string.sub(event, 1, 5) == "UNIT_" and arg1 ~= frame.unit then
-                return
-            end
-            BenillaPartyFrame_Update(frame)
-        end
-
-        -- ref PartyMemberHealthCheck: the portrait recolor law + the disconnect override.
-        function BenillaPartyFrame_HealthCheck(frame)
-            local unit = frame.unit
-            if not UnitIsConnected(unit) then
-                -- Disconnected: bar forced full and grey, portrait desaturated, icon on.
-                frame.healthbar:SetMinMaxValues(0, 1)
-                frame.healthbar:SetValue(1)
-                frame.healthbar:SetStatusBarColor(0.5, 0.5, 0.5)
-                SetDesaturation(frame.portrait, 1)
-                frame.disconnect:Show()
-                return
-            end
-            SetDesaturation(frame.portrait, nil)
-            frame.disconnect:Hide()
-            frame.healthbar:SetStatusBarColor(0.0, 1.0, 0.0)
-            local hp, hpMax = UnitHealth(unit), UnitHealthMax(unit)
-            if UnitIsDead(unit) then
-                frame.portrait:SetVertexColor(0.35, 0.35, 0.35, 1.0)
-            elseif UnitIsGhost(unit) then
-                frame.portrait:SetVertexColor(0.2, 0.2, 0.75, 1.0)
-            elseif hpMax > 0 and hp / hpMax <= 0.2 then
-                frame.portrait:SetVertexColor(1.0, 0.0, 0.0, 1.0)
-            else
-                frame.portrait:SetVertexColor(1.0, 1.0, 1.0, 1.0)
-            end
-        end
-
-        function BenillaPartyFrame_Update(frame)
-            local unit = frame.unit
-            if not UnitExists(unit) then
-                frame:Hide()
-                return
-            end
-            frame:Show()
-
-            frame.nameText:SetText(UnitName(unit) or "Unknown")
-
-            frame.healthbar:SetMinMaxValues(0, UnitHealthMax(unit))
-            frame.healthbar:SetValue(UnitHealth(unit))
-
-            local maxPower = UnitManaMax(unit)
-            if maxPower > 0 then
-                frame.manabar:Show()
-                local _, token = UnitPowerType(unit)
-                local c = BENILLA_POWER_COLORS[token] or BENILLA_POWER_COLORS.MANA
-                frame.manabar:SetStatusBarColor(c.r, c.g, c.b)
-                frame.manabar:SetMinMaxValues(0, maxPower)
-                frame.manabar:SetValue(UnitMana(unit))
-            else
-                frame.manabar:Hide()
-            end
-
-            -- Leader + master-looter icons (ref: GetPartyLeaderIndex / GetLootMethod vs own id).
-            local id = frame:GetID()
-            if GetPartyLeaderIndex() == id then
-                frame.leaderIcon:Show()
-            else
-                frame.leaderIcon:Hide()
-            end
-            local lootMethod, masterId = GetLootMethod()
-            if lootMethod == "master" and masterId == id then
-                frame.masterIcon:Show()
-            else
-                frame.masterIcon:Hide()
-            end
-
-            BenillaPartyFrame_HealthCheck(frame)
-            BenillaPartyFrame_UpdatePvP(frame)
-        end
-
-        -- ref PartyMemberFrame_UpdatePvPStatus (PartyMemberFrame.lua l.116-130), verbatim: the
-        -- same three branches the unit frames run, but the faction leg draws the GroupFrame art
-        -- (UI-Group-PVP-<group>) — only the FFA skull is shared with the big frames, because no
-        -- UI-Group-PVP-FFA ships. Decision 0646 §4; closes 0434's named deferral (the icon waited
-        -- on UnitFactionGroup, which the app now feeds).
-        function BenillaPartyFrame_UpdatePvP(frame)
-            local unit = frame.unit
-            local factionGroup = UnitFactionGroup(unit)
-            if UnitIsPVPFreeForAll(unit) then
-                frame.pvpIcon:SetTexture("Interface\\TargetingFrame\\UI-PVP-FFA")
-                frame.pvpIcon:Show()
-            elseif factionGroup and UnitIsPVP(unit) then
-                frame.pvpIcon:SetTexture("Interface\\GroupFrame\\UI-Group-PVP-" .. factionGroup)
-                frame.pvpIcon:Show()
-            else
-                frame.pvpIcon:Hide()
-            end
-        end
-
-        -- The ref's <=20% portrait alpha pulse: a 0.5 s-per-leg triangle between 127/255 and 1.
-        function BenillaPartyFrame_OnUpdate(frame, elapsed)
-            local unit = frame.unit
-            if not UnitExists(unit) or not UnitIsConnected(unit) then
-                return
-            end
-            local hp, hpMax = UnitHealth(unit), UnitHealthMax(unit)
-            if hpMax > 0 and hp > 0 and hp / hpMax <= 0.2 then
-                local t = mod(frame.flashTimer + elapsed, 1.0)
-                frame.flashTimer = t
-                local a
-                if t < 0.5 then
-                    a = 1.0 - t * (1.0 - 127 / 255) * 2
-                else
-                    a = 127 / 255 + (t - 0.5) * (1.0 - 127 / 255) * 2
-                end
-                frame.portrait:SetAlpha(a)
-            elseif frame.flashTimer ~= 0 then
-                frame.flashTimer = 0
-                frame.portrait:SetAlpha(1.0)
-            end
-        end
-
-        -- The hover tooltip: same law as the unit frames (default corner anchor + SetUnit).
-        function BenillaPartyFrame_OnEnter(frame)
-            if not UnitExists(frame.unit) then return end
-            GameTooltip_SetDefaultAnchor(GameTooltip, frame)
-            if GameTooltip:SetUnit(frame.unit) then
-                getglobal("GameTooltipTextLeft1"):SetTextColor(GameTooltip_UnitColor(frame.unit))
-            end
-        end
-
-
-        -- The right-click dropdown (decision 0434 phase 5; ref PartyMemberFrame.lua l.369-381)
-        -- + the ref's click law (l.226-237): left targets the member, right opens the PARTY
-        -- menu seated at the frame's (47, 15).
-        function PartyFrameDropDown_OnLoad()
-            UIDropDownMenu_Initialize(this, PartyFrameDropDown_Initialize, "MENU")
-        end
-
-        function PartyFrameDropDown_Initialize()
-            local dropdown
-            if UIDROPDOWNMENU_OPEN_MENU then
-                dropdown = getglobal(UIDROPDOWNMENU_OPEN_MENU)
-            else
-                dropdown = this
-            end
-            UnitPopup_ShowMenu(dropdown, "PARTY", "party" .. dropdown:GetParent():GetID())
-        end
-
-        function BenillaPartyFrame_OnClick(frame, button)
-            if button == "LeftButton" then
-                TargetUnit(frame.unit)
-            elseif button == "RightButton" then
-                ToggleDropDownMenu(1, nil, getglobal(frame:GetName() .. "DropDown"), frame:GetName(), 47, 15)
-            end
-        end
-    ]]></Script>
-
-    <!-- The shared member-frame template — ref PartyFrameTemplates.xml, 128x53 over the 128x64
-         UI-PartyFrame art at (0,-2) (the art hangs 13 px below the frame rect, as authored).
-
-         LAYERING (the ref's law): the ref nests the frame art two anonymous child frames deep so it
-         draws OVER the status bars — the bars show through the art's semi-transparent tube windows,
-         inset, their ends clipped by the rails. Ours is the UnitFrames.xml idiom, which reaches the
-         same place by the ref's OTHER route (its TargetFrame's): a $parentTextureFrame child, with
-         OnLoad pushing the bars one frame level BELOW it. Both spend a frame LEVEL, which is the
-         point — level is the one key term above the draw layer (decision 0884). Until then this file
-         instead leaned on declaring the TextureFrame after the bars, and the old draw key's
-         insertion-order tie-break; 0884 pinned the layer as bucket-wide and above the frame, which
-         put the bars' ARTWORK fills straight over the BACKGROUND art. Do not go back to declaration
-         order. The name and the leader/master/disconnect icons ride in the TextureFrame too (the ref
-         keeps them in that nested frame; left below the art, the ring would swallow the leader
-         crown). -->
-    <!-- frameStrata LOW is the ref's own (`PartyFrameTemplates.xml` l.194) and it is load-bearing,
-         not decoration. The panel windows (loot, character, merchant, quest log, …) are MEDIUM, and
-         the party frames share the top-left corner with the left-slot panel. Left in the default
-         MEDIUM, a party frame's nested HealthBar/ManaBar/TextureFrame children land one frame LEVEL
-         above a panel's background region — and level outranks insertion order in the draw key, so
-         the party frame draws straight *through* the loot window no matter which was shown last.
-         Nothing about raising could have saved it: a raise only reorders within one stratum (wow-re
-         `system/ui/scratch/toplevel-raise.md`, dispatched for exactly this). Decision 0597. -->
-    <Frame name="BenillaPartyMemberTemplate" virtual="true" hidden="true" frameStrata="LOW">
-        <Size><AbsDimension x="128" y="53"/></Size>
-        <Layers>
-            <Layer level="BACKGROUND">
-                <!-- Portrait at the bottom of the stack; the art's round window shows it through. -->
-                <Texture name="$parentPortrait">
-                    <Size><AbsDimension x="37" y="37"/></Size>
-                    <Anchors><Anchor point="TOPLEFT"><Offset><AbsDimension x="7" y="-6"/></Offset></Anchor></Anchors>
-                </Texture>
-            </Layer>
-        </Layers>
-        <Frames>
-            <StatusBar name="$parentHealthBar">
-                <Size><AbsDimension x="70" y="8"/></Size>
-                <Anchors><Anchor point="TOPLEFT"><Offset><AbsDimension x="47" y="-12"/></Offset></Anchor></Anchors>
-                <BarTexture file="Interface\TargetingFrame\UI-StatusBar"/>
-                <BarColor r="0" g="1.0" b="0"/>
-            </StatusBar>
-            <StatusBar name="$parentManaBar">
-                <Size><AbsDimension x="70" y="8"/></Size>
-                <Anchors><Anchor point="TOPLEFT"><Offset><AbsDimension x="47" y="-21"/></Offset></Anchor></Anchors>
-                <BarTexture file="Interface\TargetingFrame\UI-StatusBar"/>
-                <BarColor r="0" g="0" b="1.0"/>
-            </StatusBar>
-            <!-- The PARTY-menu dropdown host (ref $parentDropDown): hidden state-holder only —
-                 the list anchors to the member frame by name. -->
-            <Frame name="$parentDropDown" inherits="UIDropDownMenuTemplate" hidden="true">
-                <Size><AbsDimension x="10" y="10"/></Size>
-                <Anchors><Anchor point="TOP"><Offset><AbsDimension x="-20" y="-10"/></Offset></Anchor></Anchors>
-                <Scripts>
-                    <OnLoad>PartyFrameDropDown_OnLoad()</OnLoad>
-                </Scripts>
-            </Frame>
-            <Frame name="$parentTextureFrame">
-                <Size><AbsDimension x="128" y="53"/></Size>
-                <Anchors><Anchor point="TOPLEFT"/></Anchors>
-                <Layers>
-                    <Layer level="BACKGROUND">
-                        <Texture name="$parentTexture" file="Interface\TargetingFrame\UI-PartyFrame">
-                            <Size><AbsDimension x="128" y="64"/></Size>
-                            <Anchors><Anchor point="TOPLEFT"><Offset><AbsDimension x="0" y="-2"/></Offset></Anchor></Anchors>
-                        </Texture>
-                    </Layer>
-                    <Layer level="OVERLAY">
-                        <FontString name="$parentName" inherits="GameFontNormalSmall" justifyH="LEFT">
-                            <Anchors><Anchor point="BOTTOMLEFT"><Offset><AbsDimension x="50" y="43"/></Offset></Anchor></Anchors>
-                        </FontString>
-                        <Texture name="$parentLeaderIcon" file="Interface\GroupFrame\UI-Group-LeaderIcon" hidden="true">
-                            <Size><AbsDimension x="16" y="16"/></Size>
-                            <Anchors><Anchor point="TOPLEFT"/></Anchors>
-                        </Texture>
-                        <Texture name="$parentMasterIcon" file="Interface\GroupFrame\UI-Group-MasterLooter" hidden="true">
-                            <Size><AbsDimension x="16" y="16"/></Size>
-                            <Anchors><Anchor point="TOPLEFT"><Offset><AbsDimension x="32" y="0"/></Offset></Anchor></Anchors>
-                        </Texture>
-                        <!-- The group PvP icon, 32x32 TOPLEFT (-9,-15) (ref PartyFrameTemplates.xml
-                             l.298-309). Texture chosen at runtime — decision 0646 §4. -->
-                        <Texture name="$parentPVPIcon" hidden="true">
-                            <Size><AbsDimension x="32" y="32"/></Size>
-                            <Anchors><Anchor point="TOPLEFT"><Offset><AbsDimension x="-9" y="-15"/></Offset></Anchor></Anchors>
-                        </Texture>
-                        <Texture name="$parentDisconnect" file="Interface\CharacterFrame\Disconnect-Icon" hidden="true">
-                            <Size><AbsDimension x="64" y="64"/></Size>
-                            <Anchors><Anchor point="LEFT"><Offset><AbsDimension x="-7" y="-1"/></Offset></Anchor></Anchors>
-                        </Texture>
-                    </Layer>
-                </Layers>
-            </Frame>
-        </Frames>
-        <Scripts>
-            <OnLoad>BenillaPartyFrame_OnLoad(this)</OnLoad>
-            <OnEvent>BenillaPartyFrame_OnEvent(this)</OnEvent>
-            <OnUpdate>BenillaPartyFrame_OnUpdate(this, arg1)</OnUpdate>
-            <OnEnter>BenillaPartyFrame_OnEnter(this)</OnEnter>
-            <OnLeave>GameTooltip:FadeOut()</OnLeave>
-            <OnClick>BenillaPartyFrame_OnClick(this, arg1)</OnClick>
-        </Scripts>
-    </Frame>
-
-    <!-- The four instances — frame 1 at the ref's (10,-128); 2-4 cascade at the no-pet stride
-         (see the header note; the pet-frame anchor law returns with phase 4). -->
-    <Frame name="PartyMemberFrame1" inherits="BenillaPartyMemberTemplate" toplevel="true" parent="UIParent" id="1">
-        <Anchors><Anchor point="TOPLEFT"><Offset><AbsDimension x="10" y="-128"/></Offset></Anchor></Anchors>
-    </Frame>
-    <Frame name="PartyMemberFrame2" inherits="BenillaPartyMemberTemplate" toplevel="true" parent="UIParent" id="2">
-        <Anchors><Anchor point="TOPLEFT" relativeTo="PartyMemberFrame1" relativePoint="BOTTOMLEFT"><Offset><AbsDimension x="0" y="-10"/></Offset></Anchor></Anchors>
-    </Frame>
-    <Frame name="PartyMemberFrame3" inherits="BenillaPartyMemberTemplate" toplevel="true" parent="UIParent" id="3">
-        <Anchors><Anchor point="TOPLEFT" relativeTo="PartyMemberFrame2" relativePoint="BOTTOMLEFT"><Offset><AbsDimension x="0" y="-10"/></Offset></Anchor></Anchors>
-    </Frame>
-    <Frame name="PartyMemberFrame4" inherits="BenillaPartyMemberTemplate" toplevel="true" parent="UIParent" id="4">
-        <Anchors><Anchor point="TOPLEFT" relativeTo="PartyMemberFrame3" relativePoint="BOTTOMLEFT"><Offset><AbsDimension x="0" y="-10"/></Offset></Anchor></Anchors>
-    </Frame>
-
-</Ui>
diff --git a/crates/benilla-app/assets/ui/UIParent.xml b/crates/benilla-app/assets/ui/UIParent.xml
index b3f8a287..2f275c91 100644
--- a/crates/benilla-app/assets/ui/UIParent.xml
+++ b/crates/benilla-app/assets/ui/UIParent.xml
@@ -126,6 +126,13 @@
         -- the custom block at the end of the pass recomputes it, for the reason recorded there.
         PETACTIONBAR_XPOS = 36
 
+        -- ref UIParent.lua:1 — the tooltip/range re-check cadence. It lived in our ActionBar.xml,
+        -- beside the range timer that reads it; the reference's own `BuffFrame.lua:32` reads it too
+        -- and, now that BuffFrame is the reference's own file (1751), a kit can want the buff row
+        -- without wanting the action bars. So it moves to the reference's home, one line above the
+        -- constant below it.
+        TOOLTIP_UPDATE_TIME = 0.2
+
         -- ref UIParent.lua:2 — the model panes' held-button spin rate (half a turn per second),
         -- read by every `Model_OnUpdate` transcription (the character window's + inspect's).
         ROTATIONS_PER_SECOND = .5
diff --git a/crates/benilla-app/assets/ui/UnitFrames.xml b/crates/benilla-app/assets/ui/UnitFrames.xml
deleted file mode 100644
index d0e54321..00000000
--- a/crates/benilla-app/assets/ui/UnitFrames.xml
+++ /dev/null
@@ -1,2741 +0,0 @@
-<Ui>
-    <!--
-        benilla's player + target unit frames (decision 0068 slice-1 game shell), RE-SKINNED to the
-        real 1.12 UI-TargetingFrame art + geometry (dressing arc, decision 0084). The geometry below
-        is QUOTED from the real FrameXML (scratchpad ref-PlayerFrame.xml, ref-TargetFrame.xml; line
-        citations inline), turned onto our own snapshot → Unit* → event data flow. The player and
-        target are horizontal MIRRORS of one shared art (Interface\TargetingFrame\UI-TargetingFrame):
-        the player samples it flipped (portrait window on the LEFT), the target un-flipped (window on
-        the RIGHT). The mirror is a `<TexCoords left> right`; it reaches the vertex buffer un-normalized
-        via the engine's UvRect (see crates/benilla/src/ui_pass.rs).
-
-        LAYERING (matches the ref's structure). The draw order must be trough < bars < ring art < text:
-        the frame's metal well-edges overlap the bar edges so the bars read RECESSED, not pasted on top.
-        The ref gets this with a child `TargetFrameTextureFrame` (ring art) and `SetFrameLevel(bar,
-        textureFrame-1)` to push the bars beneath it, and we do the same, in BenillaUnitFrame_OnLoad:
-        the parent holds trough + portrait (+ target's name plate) in BACKGROUND; the
-        `$parentHealthBar`/`$parentManaBar` StatusBars sit at the PARENT's frame level; and
-        `$parentTextureFrame` (232×100, filling the parent) holds the ring art (BACKGROUND) + name/level/dead text
-        (OVERLAY) one level ABOVE them, so it draws over the bar edges and the portrait.
-
-        That SetFrameLevel is load-bearing, and this file used to do without it. Until decision 0884
-        the bars were held under the ring art by DECLARING `$parentTextureFrame` after them, leaning on
-        the old draw key's insertion-order tie-break between siblings at one `(strata, level)`. 0884
-        pinned the real law at the binary: the draw LAYER is bucket-wide and outranks the frame, so
-        siblings interleave by layer and the bars' ARTWORK fills painted straight over the TextureFrame's
-        BACKGROUND ring art (the frames read as pasted-on slabs — director report, 2026-08-02). Frame
-        level is the one term above the layer, which is exactly why the reference spends a level here.
-        Do not "simplify" this back into declaration order. The ring's art is a THIN
-        band with transparent corners (not an opaque surround), so the square is hidden by the portrait
-        itself — set via SetPortraitToTexture, masked to its inscribed circle (the client's portraits are
-        always round: a model render or a circular-cropped icon), so no corner reaches the ring's gap. The
-        text lives under the TextureFrame, but its GLOBAL names are the reference's flat ones
-        (`PlayerName`, `TargetDeadText`, …), not `$parent`-derived — see OnLoad's `short` prefix.
-        The shared black `…Background` trough sits behind the unfilled bar portion.
-
-        DATA FLOW UNCHANGED (pin: re-anchor + re-skin, don't rewrite the eventing): BenillaUnitFrame_*
-        handlers, the power-color table, hide-on-nonexistent-unit. Names resolve asynchronously through
-        the name-query cache (UNIT_NAME_UPDATE repaints). A powerless unit (maxPower 0) hides its power
-        bar, as the real frames do. The target frame's "DEAD" text shows when the target's health hits
-        zero (ref TargetFrame_CheckDead, ref-TargetFrame.lua l.220-228).
-
-        DEVIATIONS (noted, not bugs):
-        - Portrait: the live model bake (SetPortraitTexture(region, unit) → crates/benilla/src/portrait.rs),
-          the modern high-res 2D take on the ref's low-res model snapshot (director's call; wow-re
-          portrait RE §5-verified). Circle-cut at draw (ui_quad.wgsl, the ref's stencil shape); the
-          TemporaryPortrait stand-in shows while a model streams in; the bake poses a fresh
-          instance at Stand through the model's authored portrait camera, helms/shoulders/held
-          items riding their bones (portrait/).
-        - Bar value FontStrings (ref-PlayerFrame.xml l.79-96) are omitted — the real client hides them
-          unless the statusText CVar is set; we match the default look.
-        - TargetFrameNameBackground (the level plate) is faction-tinted (TargetFrame_CheckFaction,
-          ref-TargetFrame.lua l.144-191). A PLAYER-controlled target takes the player branch (red when
-          mutually hostile, yellow attackable-not-hostile, green when we can assist them but they are
-          PvP-flagged, else blue — a player never reads the *reaction* green); an NPC
-          takes the reaction swatch, resolved from the same faction-template / reputation decode the
-          selection ring uses (ui_unit.rs → UnitState.reaction → UnitReaction). The player branch's
-          two middle legs — yellow "attackable but not hostile" (l.158) and green "assist +
-          PvP-flagged" (l.163) — landed with the PvP wire (decision 0646); only the tapped-by-other
-          grey (l.176) is still deferred, on the tap wire. The ref gates the player
-          branch on UnitPlayerControlled (which also covers pets); we resolve its player half via
-          UnitIsPlayer, so a player-controlled PET takes the NPC reaction branch until that flag lands.
-        - The classification border swap (elite/rare art, ref-TargetFrame.lua l.205-218) LANDED with
-          decision 0782 — UnitClassification is bound and TargetFrame_CheckClassification
-          below runs the ref's branch table. Two things worth knowing at this altitude. The rank
-          `UnitClassification` reads is the client's GATED rank (`0x605620`): a pet or charmed unit
-          reports rank 0, so an enslaved elite wears the plain border, and because the tooltip's
-          ELITE/BOSS word and UnitLevel's world-boss skull read the same getter, the gate lives at
-          the app's single write (ui_unit.rs enrich_unit), not per reader. And UNIT_CLASSIFICATION_
-          CHANGED is the repaint wire, edge-fired on that rank — without it the border would only be
-          right on re-target, since Update is otherwise the sole caller.
-        - The level slot runs the full CheckLevel law (ref-TargetFrame.lua l.119-142, re-expressed in
-          Update below): corpse or "can't tell" (UnitLevel ≤ 0) → the HighLevelTexture skull;
-          otherwise the number, GetDifficultyColor-tinted when attackable, gold when not.
-        - The PVP icon landed with decision 0646 (the three-branch law in BenillaUnitFrame_UpdatePvP).
-          Its `PlayerPVPIconHitArea` did NOT, deliberately: the ref's hit area draws nothing at the
-          default settings — GameTooltip_AddNewbieTip with SHOW_NEWBIE_TIPS off and noNormalText=1
-          (which is exactly how it is called) shows no tooltip at all — while an enableMouse frame
-          over the portrait would eat the player frame's own hover and right-click. Zero pixels for a
-          real regression is not a trade; it comes back with the newbie-tip cvar if that ever ships.
-          RE-VERIFIED in 0652, both legs: ref-GameTooltip.lua l.107-123 takes the `not noNormalText`
-          branch when tips are off (so `noNormalText=1` → nothing), and "newbie" does not appear
-          anywhere in WoW.exe's strings, so SHOW_NEWBIE_TIPS has no cvar producer to be on.
-        - The rest/attack state icons landed with decision 1082, the hit indicator with 0576, and
-          the leader / master-looter pair with report B317 — the wire those three waited on has
-          existed since 0434/0453, and the list below is what is still genuinely unbuilt.
-        - The target-of-target frame landed with decision 1576 — its own block at the bottom of
-          this file, on the `"targettarget"` unit token the app now feeds.
-        - OUT (no wire / future arcs): group indicator, raid target icon, playtime.
-
-        TARGET AURA ROWS (0255's deferred slice): 5 buffs / 16 debuffs under the frame, geometry +
-        law QUOTED from ref-TargetFrame.xml (button templates l.26-87, instances l.293-481) and
-        TargetDebuffButton_Update (ref-TargetFrame.lua l.263-387): friend ⇒ buff row first, else
-        debuffs first and buffs below row 2; icons 21px shrinking to 17 when the debuff count
-        reaches the wrap; dispel-tinted UI-Debuff-Overlays border; stack count above 1; NO timers
-        (the 1.12 wire carries no duration for another unit — byte-verified, decision 0257 B6). The
-        list UnitBuff/UnitDebuff enumerate for the target is the app's straight descriptor read,
-        ascending raw slot within the half — the verified other-unit law (0257) — so icons sit in
-        server slot order, not insertion order, exactly like the reference. The target-of-target
-        branches are live since 1576: with that frame shown the rows wrap at 5 instead of 6 and
-        the buffs open under the second debuff row, because the frame stands where a six-icon row
-        would reach.
-    -->
-    <!-- ── TargetBuffButtonTemplate (ref TargetFrame.xml l.9-27, VERBATIM) ──────────────────────
-         A reference template addons INHERIT and we did not declare. `CT_UnitFrames` builds its own
-         `CT_UnitFrames_BuffButtonTemplate` on top of it (CT_TargetFrame.xml:4), and an unresolved
-         `inherits=` is SILENT — no load error, no session error, nothing in any column. The addon
-         simply gets a button with no size, no icon region and no tooltip scripts, and nothing
-         anywhere says so. That invisibility is why this row only ever appeared in the report's
-         missing-TEMPLATES ranking.
-
-         Transcribed verbatim because every piece of it already resolves here: `GameTooltip:SetOwner`
-         and `GameTooltip:SetUnitBuff` are both ours, and the icon is a plain `setAllPoints` texture.
-         The `$parentIcon` name matters — that is what a consumer getglobals to set the texture. -->
-    <Button name="TargetBuffButtonTemplate" virtual="true">
-        <Size><AbsDimension x="21" y="21"/></Size>
-        <Layers>
-            <Layer level="ARTWORK">
-                <Texture name="$parentIcon" setAllPoints="true"/>
-            </Layer>
-        </Layers>
-        <Scripts>
-            <OnEnter>
-                GameTooltip:SetOwner(this, "ANCHOR_BOTTOMRIGHT", 15, -25);
-                GameTooltip:SetUnitBuff("target", this.id);
-            </OnEnter>
-            <OnLeave>
-                GameTooltip:Hide();
-            </OnLeave>
-        </Scripts>
-    </Button>
-
-    <Script><![CDATA[
-        -- **`MAX_COMBO_POINTS` belongs to the TARGET frame in 1.12** — `TargetFrame.lua:1`, the
-        -- very first line of the file this one is our counterpart to — and this is where it lives
-        -- now (1751 window 10). It was declared in our ComboFrame.xml, whose own note said "it
-        -- lives in the ref's TargetFrame.lua; we have no such file", and that was the honest place
-        -- for it while both files were ours. The combo window is the reference's own file now and
-        -- reads this global without defining it, so it had to come home; `CombatText.xml`'s
-        -- five-point flash reads it too, and this file loads above both.
-        MAX_COMBO_POINTS = 5
-
-        -- The right-click-menu explanations the detailed-tooltip fork shows in place of the unit
-        -- lines (BenillaUnitFrame_OnEnter below) — ref GlobalStrings.lua l.2993/3081/2754/2755
-        -- (enUS), fallback form: the real localized GlobalStrings.lua runs before this file at
-        -- runtime (ui_script/mod.rs), so these only fill in for the tests. CombatText.xml's shape.
-        PARTY_OPTIONS_LABEL = PARTY_OPTIONS_LABEL or "Party Options"
-        PLAYER_OPTIONS_LABEL = PLAYER_OPTIONS_LABEL or "Player Options"
-        NEWBIE_TOOLTIP_PARTYOPTIONS = NEWBIE_TOOLTIP_PARTYOPTIONS or "If you belong to a party, you can right-click your portrait to bring up the Party Options menu. This menu will allow you to quit the party or see what looting rules the party is using. A party leader can add or remove party members, as well as change the party's looting rules."
-        NEWBIE_TOOLTIP_PLAYEROPTIONS = NEWBIE_TOOLTIP_PLAYEROPTIONS or "Right-click to bring up special commands for interacting with another player. You can inspect their equipment, issue a party invite, initiate a trade, or challenge a player to a duel. A group leader can promote or remove that player from the group."
-
-        -- ── UnitReactionColor (ref TargetFrame.lua l.6-13, verbatim) ────────────────────────
-        -- The reference's reaction→colour table, indexed by `UnitReaction`'s 1..7. Seven rows for
-        -- five distinct colours: 1 and 2 are both red, and 5/6/7 are all green — the reference
-        -- writes them out rather than collapsing them, and so do we, because an addon indexing
-        -- `UnitReactionColor[7]` must find a row rather than nil.
-        --
-        -- It lives in `TargetFrame.lua` there and here in the unit-frame file, for the same reason
-        -- `ManaBarColor` does: we ship no TargetFrame.lua, and what matters is the NAME being
-        -- published before anything reads it. pfUI indexes it in `GetColor`
-        -- (`api/unitframes.lua:2617`) on every unit-frame repaint.
-        UnitReactionColor = {
-            { r = 1.0, g = 0.0, b = 0.0 },
-            { r = 1.0, g = 0.0, b = 0.0 },
-            { r = 1.0, g = 0.5, b = 0.0 },
-            { r = 1.0, g = 1.0, b = 0.0 },
-            { r = 0.0, g = 1.0, b = 0.0 },
-            { r = 0.0, g = 1.0, b = 0.0 },
-            { r = 0.0, g = 1.0, b = 0.0 },
-        }
-
-        -- ── ManaBarColor (ref UnitFrame.lua l.1-6, verbatim) ────────────────────────────────
-        -- The reference's own table: keyed by the NUMERIC power type `UnitPowerType` returns, each
-        -- row carrying the `prefix` its bar's text is labelled with. **8 addons in the top-20 root
-        -- read `ManaBarColor` by name**, which is why it is the published one rather than a
-        -- benilla-private table — we used to keep the same five colours under
-        -- `BENILLA_POWER_COLORS`, keyed by token string and carrying no prefix, so every one of
-        -- those reads found nil.
-        --
-        -- One table, not two: the token map below is DERIVED from it rather than restated, so a
-        -- colour can never differ between what an addon reads and what our own bars paint.
-        ManaBarColor = {}
-        ManaBarColor[0] = { r = 0.00, g = 0.00, b = 1.00, prefix = MANA or "Mana" }
-        ManaBarColor[1] = { r = 1.00, g = 0.00, b = 0.00, prefix = RAGE_POINTS or "Rage" }
-        ManaBarColor[2] = { r = 1.00, g = 0.50, b = 0.25, prefix = FOCUS_POINTS or "Focus" }
-        ManaBarColor[3] = { r = 1.00, g = 1.00, b = 0.00, prefix = ENERGY_POINTS or "Energy" }
-        ManaBarColor[4] = { r = 0.00, g = 1.00, b = 1.00, prefix = HAPPINESS_POINTS or "Happiness" }
-
-        -- Our own bars look colours up by the TOKEN `UnitPowerType` also returns (its 2nd value),
-        -- so this maps token → the row above. Same objects, so `ManaBarColor` is the only source.
-        BENILLA_POWER_COLORS = {
-            MANA      = ManaBarColor[0],
-            RAGE      = ManaBarColor[1],
-            FOCUS     = ManaBarColor[2],
-            ENERGY    = ManaBarColor[3],
-            HAPPINESS = ManaBarColor[4],
-        }
-
-        -- ── The raid-target mark atlas (ref TargetFrame.lua l.460-463 + l.475-484) ──────────────
-        -- `Interface\TargetingFrame\UI-RaidTargetingIcons` is one 256x256 sheet of 4x4 64px cells,
-        -- in mark order: star, circle, diamond, triangle, moon, square, cross, skull. The helper
-        -- turns a 1..8 mark index into that cell's texcoords on a CALLER-SUPPLIED texture — it owns
-        -- no frame and reads no unit, which is why an addon can hand it a texture of its own.
-        --
-        -- Three corpus addons do, in two codebases (`Optional` and `oRA2` ship the same two files):
-        --     CustomNameplates  options.lua:363    (its options preview)
-        --     Optional / oRA2   MainTank.lua:1216, PlayerTarget.lua:1472
-        -- We answer `GetRaidTargetIndex(unit)` already (0434 §6); this is the other half — what an
-        -- addon DRAWS with that number — and without it those lines raise while redrawing a mark.
-        --
-        -- KEPT WHOLE, INCLUDING THE REFERENCE'S OWN SLIP: the row is derived with
-        -- `/ RAID_TARGET_TEXTURE_ROWS` while the column uses `mod(.., RAID_TARGET_TEXTURE_COLUMNS)`.
-        -- Rows and columns are both 4, so the two agree for every index this sheet holds and the
-        -- output is right; "fixing" it to divide by COLUMNS computes the same coords today and would
-        -- quietly diverge from the client the day a caller changes a constant. These are globals in
-        -- the reference for exactly that reason — addons read them, and two of ours are addons that
-        -- draw their own marks.
-        RAID_TARGET_ICON_DIMENSION = 64
-        RAID_TARGET_TEXTURE_DIMENSION = 256
-        RAID_TARGET_TEXTURE_COLUMNS = 4
-        RAID_TARGET_TEXTURE_ROWS = 4
-
-        function SetRaidTargetIconTexture(texture, raidTargetIconIndex)
-            raidTargetIconIndex = raidTargetIconIndex - 1
-            local left, right, top, bottom
-            local coordIncrement = RAID_TARGET_ICON_DIMENSION / RAID_TARGET_TEXTURE_DIMENSION
-            left = mod(raidTargetIconIndex, RAID_TARGET_TEXTURE_COLUMNS) * coordIncrement
-            right = left + coordIncrement
-            top = floor(raidTargetIconIndex / RAID_TARGET_TEXTURE_ROWS) * coordIncrement
-            bottom = top + coordIncrement
-            texture:SetTexCoord(left, right, top, bottom)
-        end
-
-        -- The client's UnitReactionColor table (ref-TargetFrame.lua l.6-14), indexed by
-        -- UnitReaction 1..8 (hated..exalted): 1-2 red, 3 orange, 4 neutral yellow, 5-7 green. The
-        -- name-plate reaction tint (TargetFrame_CheckFaction) reads it — this is what makes a neutral
-        -- beast's plate yellow, a hostile's red, a friendly's green.
-        BENILLA_REACTION_COLORS = {
-            { r = 1.0, g = 0.0, b = 0.0 },
-            { r = 1.0, g = 0.0, b = 0.0 },
-            { r = 1.0, g = 0.5, b = 0.0 },
-            { r = 1.0, g = 1.0, b = 0.0 },
-            { r = 0.0, g = 1.0, b = 0.0 },
-            { r = 0.0, g = 1.0, b = 0.0 },
-            { r = 0.0, g = 1.0, b = 0.0 },
-        }
-
-        -- Wire an instance to its unit token (called from each frame's OnLoad), cache its child
-        -- widgets, register the event set, and do the first paint. deadText is target-only
-        -- (getglobal returns nil for the player, which has no DEAD region) — guarded at use.
-        function BenillaUnitFrame_OnLoad(frame, unit)
-            frame.unit = unit
-            local name = frame:GetName()
-            frame.healthbar = getglobal(name .. "HealthBar")
-            frame.manabar  = getglobal(name .. "ManaBar")
-            -- TWO prefixes, both the reference's own. The bars are named off the FRAME
-            -- (`PlayerFrameHealthBar`, ref-PlayerFrame.xml l.288) but the art, text and icons are
-            -- named off the UNIT (`PlayerName` l.58, `PlayerPortrait` l.35, `TargetDeadText`
-            -- ref-TargetFrame.xml l.173) — flat globals, which is what an addon reaches for.
-            -- `short` is the frame name minus its trailing "Frame".
-            local short = string.sub(name, 1, string.len(name) - 5)
-            -- Our ring art rides a $parentTextureFrame child (the reference nests two ANONYMOUS
-            -- frames there instead, ref-PlayerFrame.xml l.49-51), so the frame whose level the bars
-            -- are pushed under is still named off the frame.
-            local tf = name .. "TextureFrame"
-            -- The recessed-bar look, the reference's own mechanism (ref-TargetFrame.lua l.32-34):
-            -- push the bars one frame level BELOW the ring art's TextureFrame. Frame level is the
-            -- only key term above the draw layer (decision 0884), so this is the only thing that can
-            -- hold a BACKGROUND ring texture over an ARTWORK bar fill. See the LAYERING note up top.
-            local textureFrameLevel = getglobal(tf):GetFrameLevel()
-            frame.healthbar:SetFrameLevel(textureFrameLevel - 1)
-            frame.manabar:SetFrameLevel(textureFrameLevel - 1)
-            -- The on-bar numerals (TextStatusBar.xml, decision 1082; the switch that shows them
-            -- is 1140's Status Bar Text). Wiring is unconditional — a frame with no text regions
-            -- gets a no-op, since SetTextStatusBarText drops a nil text and UpdateTextString skips
-            -- a bar with no TextString — so the target frame is one FontString pair away from
-            -- having them the day its hover lands. `textLockable` is the REFERENCE's own split
-            -- and the only conditional here: 1.12 sets it on the player's two bars, the pet's two
-            -- and the XP bar, and on nothing else, which is exactly why Status Bar Text pins your
-            -- own numbers and your pet's but never the target's (decision 1143).
-            -- `TextStatusBar_Initialize` is NOT called here any more — each bar calls it from its
-            -- own OnLoad, the reference's way (see the bar declarations below).
-            if SetTextStatusBarText then -- engine tests load file subsets
-                SetTextStatusBarText(frame.healthbar, getglobal(name .. "HealthBarText"))
-                SetTextStatusBarText(frame.manabar, getglobal(name .. "ManaBarText"))
-                if unit == "player" then
-                    frame.healthbar.textLockable = 1
-                    frame.manabar.textLockable = 1
-                end
-            end
-            -- The hover seam (1146): who this bar belongs to, and what its click means.
-            local click = TargetFrame_OnClick
-            if unit == "player" then
-                click = PlayerFrame_OnClick
-            end
-            frame.healthbar.owner = frame
-            frame.manabar.owner = frame
-            frame.healthbar.ownerClick = click
-            frame.manabar.ownerClick = click
-            frame.nameText  = getglobal(short .. "Name")
-            frame.levelText = getglobal(short .. "LevelText")
-            frame.deadText  = getglobal(short .. "DeadText")
-            -- Target-only (the "??" skull on the level slot); getglobal returns nil for the
-            -- player, guarded at use.
-            frame.highLevel = getglobal(short .. "HighLevelTexture")
-            -- Target-only (the level/name plate); getglobal returns nil for the player, guarded at use.
-            frame.nameBackground = getglobal(name .. "NameBackground")
-            -- The live model portrait (the real API's global, ref-UnitFrame.lua): bind the portrait
-            -- region to this frame's unit token; the app renders that unit's model off-screen and feeds
-            -- the bake back into the region (crates/benilla/src/portrait.rs). The binding is a token, so
-            -- one call suffices — the app keeps the image current per token (it re-bakes on target /
-            -- model change), which is why the ref's UNIT_PORTRAIT_UPDATE re-call isn't needed here (the
-            -- event joins the surface when addon parity wants it). Until a bake lands (no unit / model
-            -- still loading) the circle is simply empty.
-            frame.portrait = getglobal(short .. "Portrait")
-            SetPortraitTexture(frame.portrait, unit)
-            -- The PvP flag icon (decision 0646), under the TextureFrame like the ring art it
-            -- draws over — see BenillaUnitFrame_UpdatePvP.
-            frame.pvpIcon = getglobal(short .. "PVPIcon")
-            frame:RegisterEvent("PLAYER_ENTERING_WORLD")
-            frame:RegisterEvent("UNIT_HEALTH")
-            frame:RegisterEvent("UNIT_MAXHEALTH")
-            frame:RegisterEvent("UNIT_LEVEL")
-            frame:RegisterEvent("UNIT_POWER_UPDATE")
-            frame:RegisterEvent("UNIT_MAXPOWER")
-            frame:RegisterEvent("UNIT_DISPLAYPOWER")
-            frame:RegisterEvent("UNIT_NAME_UPDATE")
-            -- The PvP icon's repaint wire (decision 0646 §2) — in the reference exactly the three
-            -- frames that draw the icon register it (PlayerFrame, TargetFrame, PartyMemberFrame)
-            -- and nothing else does.
-            frame:RegisterEvent("UNIT_FACTION")
-            frame:RegisterEvent("PLAYER_TARGET_CHANGED")
-            -- The aura rows and the classification border are target-only (ref TargetFrame_OnLoad
-            -- registers UNIT_AURA and UNIT_CLASSIFICATION_CHANGED; PlayerFrame registers neither,
-            -- and there is no CheckClassification for the player — your own frame never wears a
-            -- dragon). The ring-art region is the one the border swap re-textures, so only the
-            -- target caches the handle: its presence is what gates the swap in Update, the same
-            -- nil-handle idiom highLevel/nameBackground use above.
-            if unit == "target" then
-                frame:RegisterEvent("UNIT_AURA")
-                frame:RegisterEvent("UNIT_CLASSIFICATION_CHANGED")
-                frame.frameTexture = getglobal(name .. "Texture")
-            end
-            -- The portrait hit indicator (decision 0576): only the player frame registers
-            -- UNIT_COMBAT in 1.12 (ref PlayerFrame_OnLoad — the target frame has no feedback
-            -- text). Ref: CombatFeedback_Initialize(PlayerHitIndicator, 30).
-            if unit == "player" then
-                frame.feedbackText = getglobal(short .. "HitIndicator")
-                frame.feedbackFontHeight = 30
-                frame:RegisterEvent("UNIT_COMBAT")
-                -- The status flash (ref PlayerFrame_OnLoad, decision 1082): the resting zzz /
-                -- auto-attack swords under the portrait, the gold/red ring, and the pulse
-                -- counters. Handles cached like pvpIcon above; their presence is what gates
-                -- PlayerFrame_UpdateStatus in the shared Update.
-                frame.statusTexture = getglobal(short .. "StatusTexture")
-                frame.attackBackground = getglobal(short .. "AttackBackground")
-                frame.restIcon = getglobal(short .. "RestIcon")
-                frame.attackIcon = getglobal(short .. "AttackIcon")
-                frame.statusGlow = getglobal(short .. "StatusGlow")
-                frame.restGlow = getglobal(short .. "RestGlow")
-                frame.attackGlow = getglobal(short .. "AttackGlow")
-                frame.statusCounter = 0
-                frame.statusSign = -1
-                frame.attackBackground:SetVertexColor(0.8, 0.1, 0.1)
-                frame.attackBackground:SetAlpha(0.4)
-                -- Its four wires (ref PlayerFrame_OnLoad's registrations): auto-attack toggling
-                -- (ENTER/LEAVE_COMBAT), the aggro list (REGEN_DISABLED/ENABLED), and the rest
-                -- flag (UPDATE_RESTING); PLAYER_ENTERING_WORLD is registered above for all units.
-                frame:RegisterEvent("PLAYER_ENTER_COMBAT")
-                frame:RegisterEvent("PLAYER_LEAVE_COMBAT")
-                frame:RegisterEvent("PLAYER_REGEN_DISABLED")
-                frame:RegisterEvent("PLAYER_REGEN_ENABLED")
-                frame:RegisterEvent("PLAYER_UPDATE_RESTING")
-                -- The leader / master-looter icons and their four group wires (ref
-                -- PlayerFrame_OnLoad's remaining registrations; report B317). Handle-gated in the
-                -- shared Update exactly like statusTexture above — the target frame declares
-                -- neither texture, so it never runs the law, and the party member frames run
-                -- their own (PartyFrame.xml, a different predicate: an INDEX comparison).
-                frame.leaderIcon = getglobal(short .. "LeaderIcon")
-                frame.masterIcon = getglobal(short .. "MasterIcon")
-                frame:RegisterEvent("PARTY_MEMBERS_CHANGED")
-                frame:RegisterEvent("PARTY_LEADER_CHANGED")
-                frame:RegisterEvent("PARTY_LOOT_METHOD_CHANGED")
-                frame:RegisterEvent("RAID_ROSTER_UPDATE")
-            end
-            -- A plain Frame isn't mouse-enabled by construction (only Button/EditBox are); enable it so
-            -- the hover tooltip fires (the real client's unit frames take the mouse to target/tooltip).
-            frame:EnableMouse(true)
-            UnitFrame_Update()
-        end
-
-        -- Hover: the engine's SetUnit — the byte-verified unit line law (decision 0276: name/
-        -- subtitle/level composition/PvP/Skinnable + the health bar), then the ref's reaction
-        -- recolor of line 1 (ref UnitFrame_OnEnter l.68-76: the FrameXML half of the split).
-        -- The plate goes to the DEFAULT corner, not beside the frame — ref UnitFrame_OnEnter
-        -- l.56 is GameTooltip_SetDefaultAnchor(GameTooltip, this): unit-frame tooltips live at
-        -- the screen's bottom-right like world hovers. (The TOOLTIP_UPDATE_TIME re-poll is not
-        -- ours: the engine's health watcher is the live half of it, and name/level don't drift
-        -- mid-hover yet.)
-        --
-        -- The DETAILED-TOOLTIP FORK (ref UnitFrame_OnEnter l.58-67, director-approved 0663) is the
-        -- surprising half: with tips on — 1.12's default, decision 0661 — the frame explains its
-        -- RIGHT-CLICK MENU instead of the unit, and returns BEFORE SetUnit, so the health/level
-        -- lines never render at all. Your own portrait always takes it; another player's takes it
-        -- whenever they're your target. The ref excepts PartyMemberFrame1-4 by name; ours are a
-        -- separate file with their own OnEnter (PartyFrame.xml), so there is nothing to except here.
-        --
-        -- One divergence, named: the ref gates the second branch on UnitPlayerControlled("target"),
-        -- which is true for a player OR a player's pet/charm. This engine has no such binding and no
-        -- flag to build one from — UnitIsPlayer is the nearest honest read, so a charmed mob or
-        -- another player's pet falls through to the unit tooltip where the reference would explain
-        -- the menu. The player case, which is the one anybody hovers, is exact.
-        -- ref UnitFrame_OnEnter l.55-57, ahead of everything else: the ONLY lit/grey cursor split
-        -- over a UI element in 1.12, and it is authored here in Lua rather than in the engine
-        -- (wow-re item-target-cursor-and-dropitemonunit.md 4.3). Bag and paper-doll slots have no
-        -- such branch, which is why they show the ordinary pointer.
-        -- A BAR's own hover (decision 1146; ref TextStatusBar's OnEnter/OnLeave on a mouse-enabled
-        -- bar). Two jobs, and the second is the one a naive transcription drops: reveal the numbers
-        -- while the pointer is on the bar, then hand the hover ON to the frame underneath, because
-        -- a mouse-enabled child swallows the parent's OnEnter — and with it the unit tooltip AND
-        -- the cast-cursor split that only exists over unit frames. Same for the click: the ref
-        -- routes its bars' OnMouseUp straight back to the frame's own handler (PlayerFrame.xml
-        -- l.304-306), which is what keeps a bar click targeting.
-        --
-        -- `owner`/`ownerClick` are stamped at load rather than read from GetParent(), because the
-        -- pet's bars are siblings of its TextureFrame, not children of the frame they belong to.
-        function BenillaUnitFrameBar_OnEnter(bar)
-            if TextStatusBar_UpdateTextString then
-                TextStatusBar_UpdateTextString(bar)
-                ShowTextStatusBarText(bar)
-            end
-            if bar.owner and BenillaUnitFrame_OnEnter and bar.owner.unit then
-                BenillaUnitFrame_OnEnter(bar.owner)
-            end
-        end
-
-        function BenillaUnitFrameBar_OnLeave(bar)
-            if HideTextStatusBarText then
-                HideTextStatusBarText(bar)
-            end
-            if bar.owner and BenillaUnitFrame_OnLeave and bar.owner.unit then
-                BenillaUnitFrame_OnLeave(bar.owner)
-            end
-        end
-
-        function BenillaUnitFrameBar_OnMouseUp(bar, button)
-            if bar.ownerClick then
-                bar.ownerClick(button)
-            end
-        end
-
-        -- The reference's names for the two unit-frame hover hooks, `this`-shaped, delegating to
-        -- ours. `TipBuddy.lua:2770-2773` is the exact idiom this exists for:
-        --     originalUnitFrame_OnEnter = UnitFrame_OnEnter
-        --     function UnitFrame_OnEnter() originalUnitFrame_OnEnter() ... end
-        -- Against a missing global that captured nil and raised on the first hover; against a
-        -- RENAMED one it would have called ours with no frame. See ActionBar.xml for the full note.
-        function UnitFrame_OnEnter()
-            BenillaUnitFrame_OnEnter(this)
-        end
-
-        function UnitFrame_OnLeave()
-            BenillaUnitFrame_OnLeave(this)
-        end
-
-        function BenillaUnitFrame_OnEnter(frame)
-            local unit = frame.unit
-            if SpellIsTargeting() then
-                if SpellCanTargetUnit(unit) then
-                    SetCursor("CAST_CURSOR")
-                else
-                    SetCursor("CAST_ERROR_CURSOR")
-                end
-            end
-            if not UnitExists(unit) then return end
-            GameTooltip_SetDefaultAnchor(GameTooltip, frame)
-            if SHOW_NEWBIE_TIPS == "1" then
-                if frame:GetName() == "PlayerFrame" then
-                    BenillaTooltip_AddNewbieTipFor(frame, PARTY_OPTIONS_LABEL, 1.0, 1.0, 1.0,
-                        NEWBIE_TOOLTIP_PARTYOPTIONS)
-                    return
-                elseif UnitIsPlayer("target") and not UnitIsUnit("target", "player")
-                    and not UnitIsUnit("target", "pet") then
-                    BenillaTooltip_AddNewbieTipFor(frame, PLAYER_OPTIONS_LABEL, 1.0, 1.0, 1.0,
-                        NEWBIE_TOOLTIP_PLAYEROPTIONS)
-                    return
-                end
-            end
-            if GameTooltip:SetUnit(unit) then
-                getglobal("GameTooltipTextLeft1"):SetTextColor(GameTooltip_UnitColor(unit))
-            end
-        end
-
-        -- ref UnitFrame_OnLeave l.84-88: the fade is the tips-OFF branch. With detailed tips on the
-        -- plate HIDES outright — the ref's own pairing, and the right one: an explanation that
-        -- lingers on a ramp reads as a stuck tooltip, where a unit readout fading is the client's
-        -- signature. (Items Hide, units fade — that split still holds for the world mouseover.)
-        function BenillaUnitFrame_OnLeave(frame)
-            -- ref UnitFrame_OnLeave l.86: leaving a unit frame while still targeting goes to the
-            -- GREY cast cursor, not to the base one — you have left the only thing the armed spell
-            -- could have bound.
-            if SpellIsTargeting() then SetCursor("CAST_ERROR_CURSOR") end
-            if SHOW_NEWBIE_TIPS == "1" then
-                GameTooltip:Hide()
-            else
-                GameTooltip:FadeOut()
-            end
-        end
-
-        function UnitFrame_OnEvent(event)
-            local frame = this
-            -- UNIT_* events name their unit in arg1; ignore other units' updates.
-            if string.sub(event, 1, 5) == "UNIT_" and arg1 ~= frame.unit then
-                return
-            end
-            -- The hit-indicator feed (ref PlayerFrame_OnEvent's UNIT_COMBAT arm): no repaint —
-            -- the event carries feedback, not state.
-            if event == "UNIT_COMBAT" then
-                CombatFeedback_OnCombatEvent(frame, arg2, arg3, arg4, arg5)
-                return
-            end
-            -- The status flash's state arms (ref PlayerFrame_OnEvent l.100-115, decision 1082):
-            -- inCombat = auto-attack active, onHateList = on something's aggro list; a world
-            -- entry resets both (the ref's own PLAYER_ENTERING_WORLD arm). The repaint itself
-            -- rides the shared Update below — this file's posture (the PvP sound note).
-            if event == "PLAYER_ENTERING_WORLD" then
-                frame.inCombat = nil
-                frame.onHateList = nil
-            elseif event == "PLAYER_ENTER_COMBAT" then
-                frame.inCombat = 1
-            elseif event == "PLAYER_LEAVE_COMBAT" then
-                frame.inCombat = nil
-            elseif event == "PLAYER_REGEN_DISABLED" then
-                frame.onHateList = 1
-            elseif event == "PLAYER_REGEN_ENABLED" then
-                frame.onHateList = nil
-            end
-            UnitFrame_Update()
-            -- The player's flag-change sound (decision 0646 §2/§4). The reference plays
-            -- igPVPUpdate inside PlayerFrame_UpdatePvPStatus's two show branches, which it only
-            -- ever reaches from UNIT_FACTION; our repaint runs from the shared Update on every
-            -- event, so the sound rides the (edge-fired) event instead of the repaint — one
-            -- sound per real flag change, which is what the reference audibly does.
-            if event == "UNIT_FACTION" and frame.unit == "player" and frame.pvpShown then
-                PlaySound("igPVPUpdate")
-            end
-        end
-
-        -- The PvP flag icon (decision 0646 §4). The reference writes this law twice with
-        -- identical branches — PlayerFrame_UpdatePvPStatus (ref-PlayerFrame.lua l.55-79) and the
-        -- tail of TargetFrame_CheckFaction (ref-TargetFrame.lua l.193-202) — so it lives once
-        -- here. Branch ORDER is the reference's and it is load-bearing: free-for-all wins
-        -- outright (an FFA-flagged player shows the FFA skull even while ordinarily flagged), and
-        -- the faction leg needs BOTH a resolvable side and the flag. `frame.pvpShown` is what the
-        -- caller sounds off.
-        function BenillaUnitFrame_UpdatePvP(frame)
-            local icon = frame.pvpIcon
-            if not icon then return end
-            local unit = frame.unit
-            local texture
-            if UnitIsPVPFreeForAll(unit) then
-                texture = "Interface\\TargetingFrame\\UI-PVP-FFA"
-            else
-                local factionGroup = UnitFactionGroup(unit)
-                if factionGroup and UnitIsPVP(unit) then
-                    texture = "Interface\\TargetingFrame\\UI-PVP-" .. factionGroup
-                end
-            end
-            frame.pvpShown = texture ~= nil
-            if texture then
-                icon:SetTexture(texture)
-                icon:Show()
-            else
-                icon:Hide()
-            end
-        end
-
-        -- ── Combat feedback: the portrait hit indicator (decision 0576) ──────────────────────
-        -- Our implementation of what ref CombatFeedback.lua specifies, on frame-param style (the
-        -- ref reads `this`). Timings, colors and size factors are its MEASURED values. The words
-        -- come from the GLOBALS, exactly as the ref builds this table (CombatFeedback.lua l.6-17:
-        -- CombatFeedbackText["MISS"] = TEXT(MISS)), so a localized install shows its own — the app
-        -- runs the real GlobalStrings.lua off the patch chain before this file (ui_script/mod.rs).
-        -- The enUS literals are the fallback for the test harnesses, which load no patch chain.
-        COMBATFEEDBACK_FADEINTIME = 0.2
-        COMBATFEEDBACK_HOLDTIME = 0.7
-        COMBATFEEDBACK_FADEOUTTIME = 0.3
-
-        CombatFeedbackText = {
-            INTERRUPT = INTERRUPT or "Interrupt",
-            MISS = MISS or "Miss",
-            RESIST = RESIST or "Resist",
-            DODGE = DODGE or "Dodge",
-            PARRY = PARRY or "Parry",
-            BLOCK = BLOCK or "Block",
-            EVADE = EVADE or "Evade",
-            IMMUNE = IMMUNE or "Immune",
-            DEFLECT = DEFLECT or "Deflect",
-            ABSORB = ABSORB or "Absorb",
-            REFLECT = REFLECT or "Reflect",
-        }
-
-        -- The indicator says one of two things: a NUMBER, when something moved a bar, or a WORD,
-        -- when nothing did. Everything below is that split. `scale` is a multiple of the frame's
-        -- own indicator height — 1 is "as authored" — and the multiples themselves are the
-        -- reference's measurements: half again for a big hit, three quarters for one that was
-        -- stopped, half for one that could never land.
-
-        -- The two events that move a bar the friendly way, and the colour each prints in. (A
-        -- WOUND prints a number too, but its colour depends on the school, so it is settled in
-        -- place below.)
-        local COMBAT_FEEDBACK_GAIN = {
-            HEAL     = { r = 0.0, g = 1.0, b = 0.0 },
-            ENERGIZE = { r = 0.41, g = 0.8, b = 0.94 },
-        }
-
-        -- The words that do not print at the indicator's authored height. Everything else does.
-        local COMBAT_FEEDBACK_WORD_SCALE = {
-            IMMUNE = 0.5,
-            BLOCK  = 0.75,
-        }
-
-        -- A wound that did no damage was stopped by one of three things, and in each case the
-        -- flag naming it is also the key of the word for it. Anything else was a plain miss.
-        local COMBAT_FEEDBACK_SOAKED = { ABSORB = 1, BLOCK = 1, RESIST = 1 }
-
-        -- What a zero-damage wound reads as: the word, and the size it prints at. Being stopped
-        -- reads small; missing outright reads full size, because a miss is the ordinary case.
-        local function CombatFeedback_Stopped(flags)
-            if COMBAT_FEEDBACK_SOAKED[flags] then
-                return CombatFeedbackText[flags], 0.75
-            end
-            return CombatFeedbackText["MISS"], 1.0
-        end
-
-        -- The size a landed blow reads at. A crushing blow is as loud as a critical; a glancing
-        -- one is as quiet as a soak.
-        local function CombatFeedback_HitScale(flags)
-            if flags == "CRITICAL" or flags == "CRUSHING" then
-                return 1.5
-            elseif flags == "GLANCING" then
-                return 0.75
-            end
-            return 1.0
-        end
-
-        function CombatFeedback_OnCombatEvent(frame, event, flags, amount, type)
-            local feedbackText = frame.feedbackText
-            if not feedbackText then return end
-
-            -- The default reading, which most events take unchanged: this event's own word, at the
-            -- authored height, in white. An event with no word at all prints nothing, which is the
-            -- honest thing to do with a feedback kind we do not have a string for.
-            local text = CombatFeedbackText[event]
-            local scale = 1.0
-            local r, g, b = 1.0, 1.0, 1.0
-
-            if event == "WOUND" then
-                if amount == 0 then
-                    text, scale = CombatFeedback_Stopped(flags)
-                else
-                    text = amount
-                    scale = CombatFeedback_HitScale(flags)
-                    -- A non-zero school means a spell landed it: spell damage prints yellow where
-                    -- a physical hit prints white.
-                    if type > 0 then
-                        r, g, b = 1.0, 1.0, 0.0
-                    end
-                end
-            else
-                local gain = COMBAT_FEEDBACK_GAIN[event]
-                if gain then
-                    text = amount
-                    r, g, b = gain.r, gain.g, gain.b
-                    -- A critical heal or power gain reads big. Note this is the ONLY flag that
-                    -- resizes one — a wound's crushing/glancing legs do not apply here.
-                    if flags == "CRITICAL" then
-                        scale = 1.5
-                    end
-                else
-                    scale = COMBAT_FEEDBACK_WORD_SCALE[event] or 1.0
-                end
-            end
-
-            frame.feedbackStartTime = GetTime()
-
-            feedbackText:SetTextHeight(frame.feedbackFontHeight * scale)
-            feedbackText:SetText(text)
-            feedbackText:SetTextColor(r, g, b)
-            feedbackText:SetAlpha(0.0)
-            feedbackText:Show()
-        end
-
-        -- The fade envelope (ref CombatFeedback_OnUpdate, CombatFeedback.lua l.92): 0.2 s ramp in,
-        -- 0.7 s hold, 0.3 s ramp out, then Hide. GetTime-based like the ref — no per-tick
-        -- accumulation.
-        --
-        -- **The SIGNATURE is the reference's, and it did not used to be.** The ref takes `elapsed`
-        -- and reads the frame from `this`; ours took the frame as its argument while the comment
-        -- above claimed to be the ref's. pfUI hooks this global and calls it the way the ref
-        -- declares it — `CombatFeedback_OnUpdate(arg1)` — so our version indexed the elapsed
-        -- NUMBER as a frame and raised `attempt to index local 'frame' (a number value)`.
-        --
-        -- A published global is a contract addons call BY NAME, so its signature is not ours to
-        -- improve: taking the frame explicitly reads better and is wrong. `elapsed` is unused here
-        -- (the envelope is GetTime-based) and is still named, because the parameter list is the
-        -- part addons see.
-        function CombatFeedback_OnUpdate(elapsed)
-            local frame = this
-            if not frame then return end
-            local feedbackText = frame.feedbackText
-            if not (feedbackText and feedbackText:IsVisible()) then return end
-            local elapsedTime = GetTime() - frame.feedbackStartTime
-            local fadeInTime = COMBATFEEDBACK_FADEINTIME
-            if elapsedTime < fadeInTime then
-                feedbackText:SetAlpha(elapsedTime / fadeInTime)
-                return
-            end
-            local holdTime = COMBATFEEDBACK_HOLDTIME
-            if elapsedTime < fadeInTime + holdTime then
-                feedbackText:SetAlpha(1.0)
-                return
-            end
-            local fadeOutTime = COMBATFEEDBACK_FADEOUTTIME
-            if elapsedTime < fadeInTime + holdTime + fadeOutTime then
-                feedbackText:SetAlpha(1.0 - (elapsedTime - holdTime - fadeInTime) / fadeOutTime)
-                return
-            end
-            feedbackText:Hide()
-        end
-
-        -- Pull the unit's current state and repaint. A non-existent unit hides the whole frame.
-        -- The classification border art (TargetFrame_CheckClassification, ref-TargetFrame.lua
-        -- l.205-218) — re-expressed branch for branch, and the shape is the surprise: 1.12 has FIVE
-        -- classifications but only THREE border textures, because elite, rareelite and worldboss all
-        -- take the same Elite art. There is no rare-elite border in this build and no rare-elite
-        -- tooltip word either (the level line's rank table is {"", ELITE, ELITE, BOSS, ""}), so
-        -- "rareelite" is a distinction the API makes and the pixels never do. Verified rather than
-        -- assumed, because later expansions DO ship UI-TargetingFrame-Rare-Elite and it would be the
-        -- natural thing to write: that path is absent from 1.12's patch chain entirely, and the ref
-        -- Lua sends rareelite to the Elite art.
-        --
-        -- SetTexture is the whole operation — no TexCoords, size or anchor changes. That is only
-        -- sound because all three BLPs are 256x128 (checked, not assumed), so the region's
-        -- XML-declared TexCoords (0.09375..1.0 x 0..0.78125 = the 232x100 crop) frame all three
-        -- identically, and our SetTexture touches only the path (it leaves tex_coords alone).
-        function TargetFrame_CheckClassification()
-            local frame = this
-            local classification = UnitClassification(frame.unit)
-            if classification == "worldboss" or classification == "rareelite" or classification == "elite" then
-                frame.frameTexture:SetTexture("Interface\\TargetingFrame\\UI-TargetingFrame-Elite")
-            elseif classification == "rare" then
-                frame.frameTexture:SetTexture("Interface\\TargetingFrame\\UI-TargetingFrame-Rare")
-            else
-                frame.frameTexture:SetTexture("Interface\\TargetingFrame\\UI-TargetingFrame")
-            end
-        end
-
-        -- ── One unit's two bars, from its token ───────────────────────────────────────────────
-        -- Three frames in this file paint exactly this, and until 1576 each wrote it out: the
-        -- health bar's range and value, then the power bar's colour off BENILLA_POWER_COLORS and
-        -- its own range and value — or no power bar at all, this file's convention for a unit with
-        -- no resource. Returns whether the unit HAS one, which is what the pet frame swaps its
-        -- plate on (the reference has no such art for the others and leaves an empty rail drawn).
-        --
-        -- The bars are ARGUMENTS rather than fields: the player and target frames call theirs
-        -- `manabar` and the pet frame calls its `manabar`, following the reference's own two names
-        -- for one rail, and a helper that reached for a field would have to pick a side.
-        --
-        -- NO label on the power bar. 1.12 names the resource there (ref UnitFrame_UpdateManaType
-        -- l.129 → "Rage 0 / 100" off ManaBarColor's own prefix field, and CharacterFrame_OnLoad
-        -- labels health and XP the same way). Shipped in 1146, cut on the director's call the same
-        -- day: bare numbers read better on these bars (decision 1147). The mechanism stays —
-        -- SetTextStatusBarTextPrefix is live and one call brings any label back — only the calls
-        -- are gone.
-        function BenillaUnitFrame_PaintBars(healthbar, manabar, unit)
-            healthbar:SetMinMaxValues(0, UnitHealthMax(unit))
-            healthbar:SetValue(UnitHealth(unit))
-            local maxPower = UnitManaMax(unit)
-            if maxPower <= 0 then
-                manabar:Hide()
-                return false
-            end
-            manabar:Show()
-            local _, powerToken = UnitPowerType(unit)
-            local swatch = BENILLA_POWER_COLORS[powerToken] or BENILLA_POWER_COLORS.MANA
-            manabar:SetStatusBarColor(swatch.r, swatch.g, swatch.b)
-            manabar:SetMinMaxValues(0, maxPower)
-            manabar:SetValue(UnitMana(unit))
-            return true
-        end
-
-        function UnitFrame_Update()
-            local frame = this
-            local unit = frame.unit
-            if not UnitExists(unit) then
-                frame:Hide()
-                return
-            end
-            frame:Show()
-
-            BenillaUnitFrame_PaintBars(frame.healthbar, frame.manabar, unit)
-
-            frame.nameText:SetText(UnitName(unit) or "Unknown")
-
-            -- The level slot (TargetFrame_CheckLevel, ref-TargetFrame.lua l.119-142): a corpse
-            -- target or one whose level "can't be told" (UnitLevel ≤ 0 — the −1 return for a
-            -- world boss / a hostile 10+ levels up) shows the skull instead of the number; a
-            -- told level is difficulty-colored when the target is attackable (GetDifficultyColor,
-            -- the same con law the V-plate paints its level with) and plain gold when not.
-            -- The player frame has no skull region and shows its own level, always gold.
-            local level = UnitLevel(unit)
-            if frame.highLevel then
-                if UnitIsCorpse(unit) or level <= 0 then
-                    frame.levelText:Hide()
-                    frame.highLevel:Show()
-                else
-                    frame.levelText:SetText(level)
-                    if UnitCanAttack("player", unit) then
-                        local color = GetDifficultyColor(level)
-                        frame.levelText:SetVertexColor(color.r, color.g, color.b)
-                    else
-                        frame.levelText:SetVertexColor(1.0, 0.82, 0.0)
-                    end
-                    frame.levelText:Show()
-                    frame.highLevel:Hide()
-                end
-            else
-                frame.levelText:SetText(level)
-            end
-
-            -- Tint the name/level plate (target only; TargetFrame_CheckFaction, ref-TargetFrame.lua
-            -- l.144-191). A PLAYER-CONTROLLED target takes the player branch (l.145-174); only an NPC
-            -- takes the reaction swatch (l.179-190): the resolved UnitReactionColor (neutral →
-            -- yellow), or blue when the reaction can't be told (nil) — a player never reads the
-            -- reaction green, which is why the two paths differ at all.
-            -- The player branch runs the ref's full ladder now that the
-            -- PvP wire carries it (decision 0646 §4): hostile red, else attackable-but-not-hostile
-            -- yellow (l.158), else "we can assist them but they're PvP-flagged" green (l.163), else
-            -- blue. Only the tapped-by-other grey (l.176) is still deferred — it needs the tap wire.
-            -- The ref's first leg tests mutual attackability (UnitCanAttack both ways); our
-            -- UnitCanAttack carries only the player→unit direction, so UnitIsEnemy (reaction ≤ 2)
-            -- stands in for it — the same substitution this branch has always made. (The ref gates on
-            -- UnitPlayerControlled, which also covers pets; UnitIsPlayer is the player half we can
-            -- resolve — see the header deviation.)
-            if frame.nameBackground then
-                if UnitIsPlayer(unit) then
-                    local c
-                    if UnitIsEnemy(unit, "player") then
-                        c = BENILLA_REACTION_COLORS[2]
-                    elseif UnitCanAttack("player", unit) then
-                        c = BENILLA_REACTION_COLORS[4]
-                    elseif UnitIsPVP(unit) then
-                        c = BENILLA_REACTION_COLORS[6]
-                    end
-                    if c then
-                        frame.nameBackground:SetVertexColor(c.r, c.g, c.b)
-                    else
-                        frame.nameBackground:SetVertexColor(0.0, 0.0, 1.0)
-                    end
-                else
-                    local reaction = UnitReaction(unit, "player")
-                    local c = reaction and BENILLA_REACTION_COLORS[reaction]
-                    if c then
-                        frame.nameBackground:SetVertexColor(c.r, c.g, c.b)
-                    else
-                        frame.nameBackground:SetVertexColor(0.0, 0.0, 1.0)
-                    end
-                end
-            end
-
-            -- The classification border (target only) — the ref's TargetFrame_Update calls
-            -- CheckClassification right here, between CheckFaction and CheckDead.
-            if frame.frameTexture then
-                TargetFrame_CheckClassification()
-            end
-
-            -- DEAD text (target only), ref TargetFrame_CheckDead (l.220-228) whole: Show/Hide a
-            -- region whose word the XML already carries. This site used to SetText("DEAD") a
-            -- LITERAL and blank it when alive, which put the KEY on screen in caps — `DEAD` is a
-            -- GlobalStrings key (l.898 = "Dead"), not the string, and typing a key as display text
-            -- is the "CREATE_MACROS" failure of 0983/0991 again. Nothing here names the word now:
-            -- it comes from the FontString's `text="DEAD"` attribute, which the loader resolves
-            -- through the global (loader/mod.rs resolve_text), locale and all.
-            --
-            -- `UnitIsConnected` is the reference's own second term and is what tells dead from
-            -- LINK-dead: a disconnected player reads 0 health here and is not dead. The ToT twin
-            -- (TargetofTarget_CheckDead) has carried it since it was written; this leg had not.
-            if frame.deadText then
-                if UnitHealth(unit) <= 0 and UnitIsConnected(unit) then
-                    frame.deadText:Show()
-                else
-                    frame.deadText:Hide()
-                end
-            end
-
-            -- The PvP flag icon, on both frames (decision 0646 §4).
-            BenillaUnitFrame_UpdatePvP(frame)
-
-            -- The status flash, player frame only (handle-gated like pvpIcon; decision 1082).
-            if frame.statusTexture then
-                PlayerFrame_UpdateStatus()
-            end
-
-            -- The leader / master-looter icons, player frame only (report B317).
-            if frame.leaderIcon then
-                BenillaPlayerFrame_UpdatePartyLeader(frame)
-            end
-
-            -- The aura rows (target only) — the ref's TargetFrame_Update →
-            -- TargetDebuffButton_Update: repainted on PLAYER_TARGET_CHANGED and UNIT_AURA alike.
-            if unit == "target" then
-                BenillaTargetAuras_Update()
-            end
-        end
-
-        -- ref TargetFrame.lua l.2-3.
-        MAX_TARGET_DEBUFFS = 16
-        MAX_TARGET_BUFFS = 5
-
-        -- TargetDebuffButton_Update (ref-TargetFrame.lua l.263-387), re-expressed onto the Era API
-        -- (decision 0255: UnitBuff returns name,icon,count,debuffType,… — the 1.12 original returned
-        -- the texture first). Only called with a live target (UnitFrame_Update guards).
-        -- DebuffTypeColor is defined by BuffFrame.xml, which loads AFTER this file — safe, because
-        -- this function only runs on events, never at load (no target exists at load).
-        function BenillaTargetAuras_Update()
-            local button
-            local numBuffs = 0
-            for i = 1, MAX_TARGET_BUFFS do
-                local name, icon = UnitBuff("target", i)
-                button = getglobal("TargetFrameBuff" .. i)
-                if name then
-                    getglobal(button:GetName() .. "Icon"):SetTexture(icon or BENILLA_FALLBACK_ICON)
-                    button:Show()
-                    numBuffs = numBuffs + 1
-                else
-                    button:Hide()
-                end
-            end
-
-            local numDebuffs = 0
-            for i = 1, MAX_TARGET_DEBUFFS do
-                local name, icon, count, debuffType = UnitDebuff("target", i)
-                button = getglobal("TargetFrameDebuff" .. i)
-                if name then
-                    getglobal(button:GetName() .. "Icon"):SetTexture(icon or BENILLA_FALLBACK_ICON)
-                    local color = DebuffTypeColor[debuffType] or DebuffTypeColor["none"]
-                    local countText = getglobal(button:GetName() .. "Count")
-                    if count and count > 1 then
-                        countText:SetText(count)
-                    else
-                        countText:SetText("")
-                    end
-                    getglobal(button:GetName() .. "Border"):SetVertexColor(color.r, color.g, color.b)
-                    button:Show()
-                    numDebuffs = numDebuffs + 1
-                else
-                    button:Hide()
-                end
-            end
-
-            -- The dynamic anchors (ref l.312-331). The target-of-target frame stands at the
-            -- target frame's bottom-RIGHT (decision 1576), which is where a six-icon row of
-            -- debuffs would reach: hence the wrap at 5 and, with a full buff row, the shrink
-            -- below. Both legs are the reference's, and both are live now that the frame exists.
-            local targetofTarget = TargetofTargetFrame:IsShown()
-            local debuffWrap = 6
-            if targetofTarget then
-                debuffWrap = 5
-            end
-
-            if UnitIsFriend("player", "target") then
-                TargetFrameBuff1:SetPoint("TOPLEFT", "TargetFrame", "BOTTOMLEFT", 5, 32)
-                TargetFrameDebuff1:SetPoint("TOPLEFT", "TargetFrameBuff1", "BOTTOMLEFT", 0, -2)
-            else
-                TargetFrameDebuff1:SetPoint("TOPLEFT", "TargetFrame", "BOTTOMLEFT", 5, 32)
-                if targetofTarget then
-                    -- ref l.318-326 writes this as THREE branches (< 5, 5..9, >= 10) whose first
-                    -- two are character-for-character identical; the buffs open under the second
-                    -- debuff row until there is a third. Two branches say the same thing.
-                    if numDebuffs >= 10 then
-                        TargetFrameBuff1:SetPoint("TOPLEFT", "TargetFrameDebuff11", "BOTTOMLEFT", 0, -2)
-                    else
-                        TargetFrameBuff1:SetPoint("TOPLEFT", "TargetFrameDebuff6", "BOTTOMLEFT", 0, -2)
-                    end
-                else
-                    TargetFrameBuff1:SetPoint("TOPLEFT", "TargetFrameDebuff7", "BOTTOMLEFT", 0, -2)
-                end
-            end
-
-            -- Shrink when the debuffs would overlap the frame (ref l.340-347): 21→17 icons,
-            -- 23→19 borders.
-            local debuffSize, debuffFrameSize
-            if (targetofTarget and numBuffs == 5) or numDebuffs >= debuffWrap then
-                debuffSize = 17
-                debuffFrameSize = 19
-            else
-                debuffSize = 21
-                debuffFrameSize = 23
-            end
-
-            for i = 1, 5 do
-                button = getglobal("TargetFrameBuff" .. i)
-                button:SetWidth(debuffSize)
-                button:SetHeight(debuffSize)
-            end
-            -- The ref resizes only the FIRST ROW's debuffs (l.358-368) — rows 2+ stay 17px always.
-            for i = 1, 6 do
-                button = getglobal("TargetFrameDebuff" .. i)
-                local border = getglobal(button:GetName() .. "Border")
-                border:SetWidth(debuffFrameSize)
-                border:SetHeight(debuffFrameSize)
-                button:SetWidth(debuffSize)
-                button:SetHeight(debuffSize)
-            end
-
-            -- Re-seat the wrap points (ref l.370-385). Written verbatim while the wrap was
-            -- pinned at 6 so the ToT wrap-5 leg would drop in unchanged — it did (1576), and
-            -- both directions are covered: every button the wrap-5 pass moves is put back by the
-            -- wrap-6 pass, and Debuff5 is only ever re-seated onto the anchor it is authored with.
-            getglobal("TargetFrameDebuff" .. debuffWrap):ClearAllPoints()
-            getglobal("TargetFrameDebuff" .. debuffWrap):SetPoint("LEFT", getglobal("TargetFrameDebuff" .. (debuffWrap - 1)), "RIGHT", 3, 0)
-            getglobal("TargetFrameDebuff" .. (debuffWrap + 1)):ClearAllPoints()
-            getglobal("TargetFrameDebuff" .. (debuffWrap + 1)):SetPoint("TOPLEFT", "TargetFrameDebuff1", "BOTTOMLEFT", 0, -2)
-            getglobal("TargetFrameDebuff" .. (debuffWrap + 2)):ClearAllPoints()
-            getglobal("TargetFrameDebuff" .. (debuffWrap + 2)):SetPoint("LEFT", getglobal("TargetFrameDebuff" .. (debuffWrap + 1)), "RIGHT", 3, 0)
-            if debuffWrap == 5 then
-                TargetFrameDebuff11:ClearAllPoints()
-                TargetFrameDebuff11:SetPoint("TOPLEFT", "TargetFrameDebuff6", "BOTTOMLEFT", 0, -2)
-            else
-                TargetFrameDebuff11:ClearAllPoints()
-                TargetFrameDebuff11:SetPoint("LEFT", "TargetFrameDebuff10", "RIGHT", 3, 0)
-            end
-        end
-
-        -- The aura hover (ref TargetDebuffButtonTemplate/TargetBuffButtonTemplate OnEnter,
-        -- l.60-62/l.79-81): the aura tooltip, seated BOTTOMRIGHT of the button.
-        function BenillaTargetAuraButton_OnEnter(button, harmful)
-            if not GameTooltip then return end -- engine tests load file subsets
-            GameTooltip:SetOwner(button, "ANCHOR_BOTTOMRIGHT", 15, -25)
-            if harmful then
-                GameTooltip:SetUnitDebuff("target", button:GetID())
-            else
-                GameTooltip:SetUnitBuff("target", button:GetID())
-            end
-        end
-
-        -- The status flash's paint (ref PlayerFrame_UpdateStatus, re-expressed onto frame-param
-        -- style; decision 1082). Priority is the ref's: RESTING wins over combat — sitting in an
-        -- inn mid-auto-attack shows the zzz — then the auto-attack state (gold ring/zzz vs red
-        -- ring/swords/red disc), then bare swords for on-someone's-aggro-list, then nothing.
-        function PlayerFrame_UpdateStatus()
-            local frame = this
-            if IsResting() then
-                frame.statusTexture:SetVertexColor(1.0, 0.88, 0.25, 1.0)
-                frame.statusTexture:Show()
-                frame.restIcon:Show()
-                frame.attackIcon:Hide()
-                frame.restGlow:Show()
-                frame.attackGlow:Hide()
-                frame.statusGlow:Show()
-                frame.attackBackground:Hide()
-            elseif frame.inCombat then
-                frame.statusTexture:SetVertexColor(1.0, 0.0, 0.0, 1.0)
-                frame.statusTexture:Show()
-                frame.attackIcon:Show()
-                frame.restIcon:Hide()
-                frame.attackGlow:Show()
-                frame.restGlow:Hide()
-                frame.statusGlow:Show()
-                frame.attackBackground:Show()
-            elseif frame.onHateList then
-                frame.attackIcon:Show()
-                frame.restIcon:Hide()
-                frame.statusGlow:Hide()
-                frame.attackBackground:Hide()
-            else
-                frame.statusTexture:Hide()
-                frame.restIcon:Hide()
-                frame.attackIcon:Hide()
-                frame.statusGlow:Hide()
-                frame.attackBackground:Hide()
-            end
-        end
-
-        -- The leader / master-looter icons on the player's own frame (ref
-        -- PlayerFrame_UpdatePartyLeader, re-expressed onto frame-param style; report B317).
-        --
-        -- Two DIFFERENT predicates, and the asymmetry is the reference's own. The leader icon asks
-        -- IsPartyLeader() — a boolean about us — where the member frames ask whether the leader
-        -- INDEX equals their id, because the player has no index on that scale (0 is "the player
-        -- leads", not "party0"). The master icon then asks whether GetLootMethod's second return
-        -- is 0, which is that same scale reading "the player is master looter"; the group test
-        -- beside it is the reference's own guard, and it is not redundant with ours — a solo
-        -- player's master_looter is None, so `masterId == 0` is already false, but reproducing the
-        -- expression keeps us honest if that ever stops being true.
-        function BenillaPlayerFrame_UpdatePartyLeader(frame)
-            if IsPartyLeader() then
-                frame.leaderIcon:Show()
-            else
-                frame.leaderIcon:Hide()
-            end
-            local lootMethod, masterId = GetLootMethod()
-            if masterId == 0 and (GetNumPartyMembers() > 0 or GetNumRaidMembers() > 0) then
-                frame.masterIcon:Show()
-            else
-                frame.masterIcon:Hide()
-            end
-        end
-
-        -- ref PlayerFrame_OnUpdate: the status pulse — a 0.5 s triangle wave between alpha
-        -- 55/255 and 255/255 on the ADD-blend status ring and the icon glow, run only while the
-        -- ring is visible (resting or auto-attacking); the hit-indicator fade rides the same
-        -- tick, exactly as before.
-        function PlayerFrame_OnUpdate(elapsed)
-            local frame = this
-            if frame.statusTexture:IsVisible() then
-                local counter = frame.statusCounter + elapsed
-                local sign = frame.statusSign
-                if counter > 0.5 then
-                    sign = -sign
-                    frame.statusSign = sign
-                end
-                counter = mod(counter, 0.5)
-                frame.statusCounter = counter
-                local alpha
-                if sign == 1 then
-                    alpha = (55 + counter * 400) / 255
-                else
-                    alpha = (255 - counter * 400) / 255
-                end
-                frame.statusTexture:SetAlpha(alpha)
-                frame.statusGlow:SetAlpha(alpha)
-            end
-            -- `this` is already the frame here (`local frame = this` above), which is the
-            -- contract the ref's own signature relies on.
-            CombatFeedback_OnUpdate(elapsed)
-        end
-
-        -- Left-click the player frame to target yourself (ref PlayerFrame_OnClick, the LeftButton
-        -- branch: an item on the cursor auto-equips, otherwise TargetUnit("player")); right-click
-        -- opens the SELF menu (ref's ToggleDropDownMenu at (106, 27), decision 0434 phase 5). The
-        -- ref's frame is a Button; ours is a mouse-enabled Frame, which fires OnClick on release
-        -- with arg1 = the button. The self-target itself is the byte-verified way the client
-        -- selects its own unit; the world-model click is a separate path, deliberately left out
-        -- (director's call).
-        function PlayerFrame_OnClick(button)
-            if button == "RightButton" then
-                ToggleDropDownMenu(1, nil, PlayerFrameDropDown, "PlayerFrame", 106, 27)
-                return
-            end
-            if button ~= "LeftButton" then return end
-            if CursorHasItem() then
-                AutoEquipCursorItem()
-            else
-                TargetUnit("player")
-            end
-        end
-
-        -- The right-click dropdowns (decision 0434 phase 5; ref TargetFrame.lua l.431-455,
-        -- PlayerFrame.lua l.235-241): MENU displayMode over the shared kit (UIDropDownMenu.xml),
-        -- the menus themselves from UnitPopup.xml. The menu pick is the ref's law: self → SELF,
-        -- party member → PARTY, other player → PLAYER, NPC → the bare raid-target icon list.
-        function TargetFrameDropDown_OnLoad()
-            UIDropDownMenu_Initialize(this, TargetFrameDropDown_Initialize, "MENU")
-        end
-
-        -- Which menu the CURRENT target gets, and the heading that menu needs (only the bare mark
-        -- list carries one — the unit menus title themselves from the unit). Most specific first:
-        --   yourself                     → SELF
-        --   your own pet                 → PET. Selecting your pet and right-clicking the TARGET
-        --                                  frame is still the pet's menu; the ref's own second
-        --                                  branch (TargetFrame.lua l.440-441), which sat as a
-        --                                  comment here until the "pet" token (0990) and then the
-        --                                  menu itself (1066).
-        --   anything that is not a player → an NPC, which gets only the raid-mark list
-        --   a player, in your party or not → PARTY / PLAYER
-        local function TargetFrameMenu()
-            if UnitIsUnit("target", "player") then
-                return "SELF"
-            end
-            if UnitIsUnit("target", "pet") then
-                return "PET"
-            end
-            if not UnitIsPlayer("target") then
-                return "RAID_TARGET_ICON", RAID_TARGET_ICON
-            end
-            if UnitInParty("target") then
-                return "PARTY"
-            end
-            return "PLAYER"
-        end
-
-        function TargetFrameDropDown_Initialize()
-            local menu, name = TargetFrameMenu()
-            if menu then
-                UnitPopup_ShowMenu(TargetFrameDropDown, menu, "target", name)
-            end
-        end
-
-        function PlayerFrameDropDown_OnLoad()
-            UIDropDownMenu_Initialize(this, PlayerFrameDropDown_Initialize, "MENU")
-        end
-
-        function PlayerFrameDropDown_Initialize()
-            UnitPopup_ShowMenu(PlayerFrameDropDown, "SELF", "player")
-        end
-
-        -- ref TargetFrame_OnClick: right-click opens the unit menu at (120, 10). The ref's
-        -- LeftButton branch (SpellTargetUnit / DropItemOnUnit) rides the spell-cursor and
-        -- item-drop slices — a bare left-click is a no-op on the ref too.
-        function TargetFrame_OnClick(button)
-            if button == "RightButton" then
-                ToggleDropDownMenu(1, nil, TargetFrameDropDown, "TargetFrame", 120, 10)
-            end
-        end
-    ]]></Script>
-
-    <!--
-        PLAYER FRAME (ref-PlayerFrame.xml). Button 232×100 at UIParent TOPLEFT (-19,-4) (l.4-13); the
-        negative x trims the art's transparent left padding, seating the visible frame flush at the
-        screen's top-left, exactly as the real client does (our UIParent is the screen).
-    -->
-    <!-- frameStrata BACKGROUND is the ref's own (`PlayerFrame.xml` l.4) — the unit frames live
-         BELOW the MEDIUM panel windows on purpose, and the player frame shares the top-left corner
-         with the left-slot panel. See the note on PartyFrame.xml's template (decision 0597) for why
-         the default MEDIUM makes a unit frame's bar children draw through a window's background. -->
-    <Frame name="PlayerFrame" toplevel="true" parent="UIParent" frameStrata="BACKGROUND">
-        <Size><AbsDimension x="232" y="100"/></Size>
-        <Anchors>
-            <Anchor point="TOPLEFT" relativePoint="TOPLEFT"><Offset><AbsDimension x="-19" y="-4"/></Offset></Anchor>
-        </Anchors>
-        <Layers>
-            <Layer level="BACKGROUND">
-                <!-- The bar trough: 119×41 black a=0.5 behind both bars (ref l.20-32). -->
-                <Texture name="$parentBackground">
-                    <Size><AbsDimension x="119" y="41"/></Size>
-                    <Anchors>
-                        <Anchor point="TOPLEFT" relativePoint="TOPLEFT"><Offset><AbsDimension x="106" y="-22"/></Offset></Anchor>
-                    </Anchors>
-                    <Color r="0" g="0" b="0" a="0.5"/>
-                </Texture>
-                <!-- Portrait 64×64 TOPLEFT (42,-12) (ref l.35-46, which puts it in ARTWORK; ours sits
-                     in BACKGROUND, a leftover of the pre-0884 layering. The ring art now clears it by
-                     frame LEVEL, and nothing else in this layer overlaps the portrait's square, so the
-                     two are indistinguishable here — left alone rather than churned inside a bug fix).
-                     Texture set in OnLoad via SetPortraitToTexture (circle-masked). -->
-                <Texture name="PlayerPortrait">
-                    <Size><AbsDimension x="64" y="64"/></Size>
-                    <Anchors>
-                        <Anchor point="TOPLEFT" relativePoint="TOPLEFT"><Offset><AbsDimension x="42" y="-12"/></Offset></Anchor>
-                    </Anchors>
-                </Texture>
-            </Layer>
-            <!-- The ring art + name/level text live in $parentTextureFrame below, one frame level
-                 ABOVE the bars, so they draw OVER the bar edges — the recessed-bar look. OnLoad puts
-                 them there (SetFrameLevel); see the LAYERING note at the top of this file. -->
-        </Layers>
-        <Frames>
-            <!-- Health bar 119×12 TOPLEFT (106,-41), UI-StatusBar, green (ref l.288-315). -->
-            <StatusBar name="$parentHealthBar" enableMouse="true">
-                <Size><AbsDimension x="119" y="12"/></Size>
-                <Anchors>
-                    <Anchor point="TOPLEFT" relativePoint="TOPLEFT"><Offset><AbsDimension x="106" y="-41"/></Offset></Anchor>
-                </Anchors>
-                <BarTexture file="Interface\TargetingFrame\UI-StatusBar"/>
-                <BarColor r="0.0" g="1.0" b="0.0"/>
-                <Scripts>
-                    <!-- The reference initialises a numerals bar from the BAR'S OWN OnLoad
-                         (PlayerFrame.xml l.300-303, PetFrame.xml l.138/163), never from the parent
-                         with the bar as an argument — `TextStatusBar_Initialize()` takes no
-                         argument in 1.12 and acts on `this`. Ours called it from the parent's
-                         OnLoad, which needed a widened signature and would have broken silently
-                         the day TextStatusBar.xml came off the player's chain (decisions 1793). -->
-                    <OnLoad>if TextStatusBar_Initialize then TextStatusBar_Initialize() end</OnLoad>
-                    <OnEvent>if TextStatusBar_OnEvent then TextStatusBar_OnEvent(arg1, arg2) end</OnEvent>
-                    <OnValueChanged>if TextStatusBar_OnValueChanged then TextStatusBar_OnValueChanged() end</OnValueChanged>
-                    <OnEnter>BenillaUnitFrameBar_OnEnter(self)</OnEnter>
-                    <OnLeave>BenillaUnitFrameBar_OnLeave(self)</OnLeave>
-                    <OnMouseUp>BenillaUnitFrameBar_OnMouseUp(self, arg1)</OnMouseUp>
-                </Scripts>
-            </StatusBar>
-            <!-- Power bar 119×12 TOPLEFT (106,-52), UI-StatusBar; color set at runtime (ref l.316-341). -->
-            <StatusBar name="$parentManaBar" enableMouse="true">
-                <Size><AbsDimension x="119" y="12"/></Size>
-                <Anchors>
-                    <Anchor point="TOPLEFT" relativePoint="TOPLEFT"><Offset><AbsDimension x="106" y="-52"/></Offset></Anchor>
-                </Anchors>
-                <BarTexture file="Interface\TargetingFrame\UI-StatusBar"/>
-                <BarColor r="0.0" g="0.0" b="1.0"/>
-                <Scripts>
-                    <!-- The reference initialises a numerals bar from the BAR'S OWN OnLoad
-                         (PlayerFrame.xml l.300-303, PetFrame.xml l.138/163), never from the parent
-                         with the bar as an argument — `TextStatusBar_Initialize()` takes no
-                         argument in 1.12 and acts on `this`. Ours called it from the parent's
-                         OnLoad, which needed a widened signature and would have broken silently
-                         the day TextStatusBar.xml came off the player's chain (decisions 1793). -->
-                    <OnLoad>if TextStatusBar_Initialize then TextStatusBar_Initialize() end</OnLoad>
-                    <OnEvent>if TextStatusBar_OnEvent then TextStatusBar_OnEvent(arg1, arg2) end</OnEvent>
-                    <OnValueChanged>if TextStatusBar_OnValueChanged then TextStatusBar_OnValueChanged() end</OnValueChanged>
-                    <OnEnter>BenillaUnitFrameBar_OnEnter(self)</OnEnter>
-                    <OnLeave>BenillaUnitFrameBar_OnLeave(self)</OnLeave>
-                    <OnMouseUp>BenillaUnitFrameBar_OnMouseUp(self, arg1)</OnMouseUp>
-                </Scripts>
-            </StatusBar>
-            <!-- The ring art + text, over the bars (ref TargetFrameTextureFrame). 232×100 fills the
-                 parent; it draws over the bar edges because OnLoad pushes the bars one frame level
-                 BELOW it (the ref's SetFrameLevel(bar, textureFrame-1)) — NOT because of where it
-                 is declared. See the LAYERING note at the top of this file. -->
-            <Frame name="$parentTextureFrame">
-                <Size><AbsDimension x="232" y="100"/></Size>
-                <Anchors>
-                    <Anchor point="TOPLEFT" relativePoint="TOPLEFT"><Offset><AbsDimension x="0" y="0"/></Offset></Anchor>
-                </Anchors>
-                <Layers>
-                    <Layer level="BACKGROUND">
-                        <!-- Ring art, MIRRORED: TexCoords left=1.0 right=0.09375 top=0 bottom=0.78125 (ref l.55-57). -->
-                        <Texture name="PlayerFrameTexture" file="Interface\TargetingFrame\UI-TargetingFrame">
-                            <Size><AbsDimension x="232" y="100"/></Size>
-                            <Anchors>
-                                <Anchor point="TOPLEFT" relativePoint="TOPLEFT"><Offset><AbsDimension x="0" y="0"/></Offset></Anchor>
-                            </Anchors>
-                            <TexCoords left="1.0" right="0.09375" top="0" bottom="0.78125"/>
-                        </Texture>
-                        <!-- Name and level ride BACKGROUND with the ring art, like the ref's
-                             (ref-PlayerFrame.xml l.54-97) — NOT the OVERLAY the state icons sit
-                             in. The layer choice is load-bearing for the level number: the zzz /
-                             crossed-swords badge (OVERLAY, below) sits exactly on the level
-                             badge, and the client's bucket-wide texture-before-fontstring order
-                             (decision 0884) means a fontstring can never hide UNDER a texture
-                             of its own layer — the ref hides the number while resting by putting
-                             it in a LOWER layer than the badge. Shipped in OVERLAY by 1082, the
-                             number rode ON the badge (director report, 2026-08-07); decision 1093. -->
-                        <!-- Name 100×10 CENTER (50,19) (ref l.58-69).
-
-                             The NAME is the reference's own, literally — and so is every other
-                             art/text/icon region in the three unit frames. They used to derive
-                             from `$parent`, which published `PlayerFrameTextureFrameNameText` and
-                             left `PlayerName` (PlayerFrame.xml:58), `TargetName`
-                             (TargetFrame.xml:152) and `PetName` (PetFrame.xml:69) — the names an
-                             addon actually reaches for — nil. See BenillaUnitFrame_OnLoad's
-                             `short` prefix for how the shared binder composes them now.
-
-                             **This was tried once and REJECTED, and the rejection was right on
-                             its evidence** — the block that stood here argued: (i) not free, since
-                             `UnitFrame_OnLoad` composes these names inside `getglobal`, so a text
-                             search finds nothing and the rename breaks every unit frame (it broke
-                             40 tests); and (ii) buys nothing, since a "why" read-back over the
-                             218-addon corpus matched ZERO error rows for `TargetName`, its one
-                             syntactic caller being a `<Anchor relativeTo=>` in an addon that dies
-                             earlier anyway. It closed "revisit if a row ever names it" (1222's
-                             clause: a shadowed name with no observable caller is building against
-                             a guess).
-
-                             What changed (1719): the condition it named was met, and its cost
-                             premise expired. A grep of the top-20 root gives `ManaBarColor` 8
-                             readers, `PlayerFrameManaBar` 3, `PlayerFrameTexture`/
-                             `TargetFrameTexture`/`PlayerStatusTexture`/`TargetFrameManaBar` 2
-                             each, and `PlayerName`/`TargetName`/`PetName` 1 each. ShaguTweaks
-                             dies on `TargetFrameManaBar` at `health-numbers.lua:22`. **Fifteen of
-                             the twenty-two renames still have zero measured readers** and were
-                             kept for consistency with the reference and because the cost was
-                             already paid, NOT because demand was shown — say the word and they go
-                             back. -->
-                        <FontString name="PlayerName" inherits="GameFontNormalSmall" text="Unknown">
-                            <Size><AbsDimension x="100" y="10"/></Size>
-                            <Anchors>
-                                <Anchor point="CENTER" relativePoint="CENTER"><Offset><AbsDimension x="50" y="19"/></Offset></Anchor>
-                            </Anchors>
-                        </FontString>
-                        <!-- Level number CENTER (-63,-16) (ref l.70-78). -->
-                        <FontString name="PlayerLevelText" inherits="GameFontNormalSmall">
-                            <Anchors>
-                                <Anchor point="CENTER" relativePoint="CENTER"><Offset><AbsDimension x="-63" y="-16"/></Offset></Anchor>
-                            </Anchors>
-                        </FontString>
-                        <!-- The on-bar numerals, "value / max" (decision 1143). The reference's
-                             own seats are CENTER (50,4) and (50,-8) (ref-PlayerFrame.xml l.79-96);
-                             ours sit **1 px lower** — the director's call on the shipped result,
-                             2026-08-08, and the deviation is recorded rather than the literals
-                             (decision 1145). Why a digit string reads high at the ref's own offset:
-                             a FontString centres on its LINE BOX, ascent + descent, and digits
-                             occupy only the ascent — so the visible mass sits above the box centre
-                             and a numerals-only string looks lifted inside a 12 px bar. The nudge
-                             is optical, and it belongs on the seat rather than on the centring,
-                             which every other string in the UI shares.
-                             The LAYER is the reference's: BACKGROUND beside the name and level, not
-                             the OVERLAY the state badges sit in, for the reason spelled out above.
-                             They draw over the bar FILL because the whole TextureFrame outranks the
-                             bars by a frame level. Empty until Status Bar Text is on or (later) the
-                             bar is hovered — TextStatusBar.xml owns that decision, not this file. -->
-                        <FontString name="PlayerFrameHealthBarText" inherits="TextStatusBarText">
-                            <Anchors>
-                                <Anchor point="CENTER" relativePoint="CENTER"><Offset><AbsDimension x="50" y="3"/></Offset></Anchor>
-                            </Anchors>
-                        </FontString>
-                        <FontString name="PlayerFrameManaBarText" inherits="TextStatusBarText">
-                            <Anchors>
-                                <Anchor point="CENTER" relativePoint="CENTER"><Offset><AbsDimension x="50" y="-9"/></Offset></Anchor>
-                            </Anchors>
-                        </FontString>
-                    </Layer>
-                    <Layer level="ARTWORK">
-                        <!-- The PvP flag icon, 64×64 TOPLEFT (18,-20) (ref PlayerPVPIcon,
-                             ref-PlayerFrame.xml l.124-135) — ARTWORK over the BACKGROUND ring art,
-                             like the ref's. Texture chosen at runtime (decision 0646 §4); the ref's
-                             PlayerPVPIconHitArea is deliberately OUT (see the header). -->
-                        <Texture name="PlayerPVPIcon" hidden="true">
-                            <Size><AbsDimension x="64" y="64"/></Size>
-                            <Anchors>
-                                <Anchor point="TOPLEFT" relativePoint="TOPLEFT"><Offset><AbsDimension x="18" y="-20"/></Offset></Anchor>
-                            </Anchors>
-                        </Texture>
-                        <!-- The status ring (ref PlayerStatusTexture, ref-PlayerFrame.xml l.99-111):
-                             the ADD-blend glow ring around the whole frame, tinted gold while
-                             resting / red while auto-attacking, pulsed by the OnUpdate flash
-                             (decision 1082). 190×66 TOPLEFT (35,-8), the ring art's own recess. -->
-                        <Texture name="PlayerStatusTexture" file="Interface\CharacterFrame\UI-Player-Status" alphaMode="ADD" hidden="true">
-                            <Size><AbsDimension x="190" y="66"/></Size>
-                            <Anchors>
-                                <Anchor point="TOPLEFT" relativePoint="TOPLEFT"><Offset><AbsDimension x="35" y="-8"/></Offset></Anchor>
-                            </Anchors>
-                            <TexCoords left="0" right="0.74609375" top="0" bottom="0.53125"/>
-                        </Texture>
-                        <!-- ref PlayerAttackBackground (l.112-123): the dark red disc behind the
-                             attack state icon; OnLoad tints it (0.8,0.1,0.1) at alpha 0.4. -->
-                        <Texture name="PlayerAttackBackground" file="Interface\TargetingFrame\UI-TargetingFrame-AttackBackground" hidden="true">
-                            <Size><AbsDimension x="32" y="32"/></Size>
-                            <Anchors>
-                                <Anchor point="TOPLEFT" relativePoint="TOPLEFT"><Offset><AbsDimension x="37" y="-50"/></Offset></Anchor>
-                            </Anchors>
-                        </Texture>
-                    </Layer>
-                    <Layer level="OVERLAY">
-                        <!-- The portrait hit indicator (ref PlayerHitIndicator, decision 0576):
-                             CENTER at (73,-42) from the frame's TOPLEFT — the portrait circle's
-                             center. Hidden until a UNIT_COMBAT event lands; CombatFeedback drives
-                             text/size/color and the fade. -->
-                        <FontString name="PlayerHitIndicator" hidden="true" inherits="NumberFontNormalHuge">
-                            <Anchors>
-                                <Anchor point="CENTER" relativePoint="TOPLEFT"><Offset><AbsDimension x="73" y="-42"/></Offset></Anchor>
-                            </Anchors>
-                        </FontString>
-                        <!-- Leader + master-looter icons (ref PlayerLeaderIcon / PlayerMasterIcon,
-                             ref-PlayerFrame.xml l.147-170): 16×16 at the frame's TOPLEFT (44,-10)
-                             and (80,-10) — above the portrait ring, left to right. The reference
-                             seats them in this same OVERLAY layer and in the same frame-filling
-                             child the state icons use, so the offsets are directly comparable to
-                             $parentRestIcon's below. Shown by BenillaPlayerFrame_UpdatePartyLeader.
-                             Report B317: the member frames have carried these since 0434 phase 2;
-                             the player frame was built before the party wire and listed them OUT. -->
-                        <Texture name="PlayerLeaderIcon" file="Interface\GroupFrame\UI-Group-LeaderIcon" hidden="true">
-                            <Size><AbsDimension x="16" y="16"/></Size>
-                            <Anchors>
-                                <Anchor point="TOPLEFT" relativePoint="TOPLEFT"><Offset><AbsDimension x="44" y="-10"/></Offset></Anchor>
-                            </Anchors>
-                        </Texture>
-                        <Texture name="PlayerMasterIcon" file="Interface\GroupFrame\UI-Group-MasterLooter" hidden="true">
-                            <Size><AbsDimension x="16" y="16"/></Size>
-                            <Anchors>
-                                <Anchor point="TOPLEFT" relativePoint="TOPLEFT"><Offset><AbsDimension x="80" y="-10"/></Offset></Anchor>
-                            </Anchors>
-                        </Texture>
-                        <!-- The state icon pair under the portrait (ref PlayerRestIcon /
-                             PlayerAttackIcon, ref-PlayerFrame.xml l.171-201): the two halves of
-                             UI-StateIcon — zzz left, crossed swords right (decision 1082). -->
-                        <Texture name="PlayerRestIcon" file="Interface\CharacterFrame\UI-StateIcon" hidden="true">
-                            <Size><AbsDimension x="31" y="33"/></Size>
-                            <Anchors>
-                                <Anchor point="TOPLEFT" relativePoint="TOPLEFT"><Offset><AbsDimension x="37" y="-49"/></Offset></Anchor>
-                            </Anchors>
-                            <TexCoords left="0" right="0.5" top="0" bottom="0.421875"/>
-                        </Texture>
-                        <Texture name="PlayerAttackIcon" file="Interface\CharacterFrame\UI-StateIcon" hidden="true">
-                            <Size><AbsDimension x="32" y="32"/></Size>
-                            <Anchors>
-                                <Anchor point="TOPLEFT" relativeTo="PlayerRestIcon"><Offset><AbsDimension x="1" y="1"/></Offset></Anchor>
-                            </Anchors>
-                            <TexCoords left="0.5" right="1.0" top="0" bottom="0.5"/>
-                        </Texture>
-                    </Layer>
-                </Layers>
-            </Frame>
-            <!-- The state icon's own ADD-blend glow (ref PlayerStatusGlow, ref-PlayerFrame.xml
-                 l.216-248): a sibling FRAME over the icon so the whole thing can pulse as one
-                 SetAlpha group with the status ring (the OnUpdate flash, decision 1082). -->
-            <Frame name="PlayerStatusGlow" hidden="true">
-                <Size><AbsDimension x="32" y="32"/></Size>
-                <Anchors>
-                    <Anchor point="TOPLEFT" relativeTo="PlayerRestIcon"><Offset><AbsDimension x="0" y="0"/></Offset></Anchor>
-                </Anchors>
-                <Layers>
-                    <Layer level="OVERLAY">
-                        <Texture name="PlayerRestGlow" file="Interface\CharacterFrame\UI-StateIcon" alphaMode="ADD">
-                            <Size><AbsDimension x="32" y="32"/></Size>
-                            <Anchors>
-                                <Anchor point="TOPLEFT" relativePoint="TOPLEFT"/>
-                            </Anchors>
-                            <TexCoords left="0" right="0.5" top="0.5" bottom="1.0"/>
-                        </Texture>
-                        <Texture name="PlayerAttackGlow" file="Interface\CharacterFrame\UI-StateIcon" alphaMode="ADD">
-                            <Size><AbsDimension x="32" y="32"/></Size>
-                            <Anchors>
-                                <Anchor point="TOPLEFT" relativePoint="TOPLEFT"/>
-                            </Anchors>
-                            <TexCoords left="0.5" right="1.0" top="0.5" bottom="1.0"/>
-                        </Texture>
-                    </Layer>
-                </Layers>
-            </Frame>
-        </Frames>
-        <Scripts>
-            <OnLoad><![CDATA[BenillaUnitFrame_OnLoad(this, "player")]]></OnLoad>
-            <OnEvent><![CDATA[UnitFrame_OnEvent(event)]]></OnEvent>
-            <OnUpdate><![CDATA[PlayerFrame_OnUpdate(arg1)]]></OnUpdate>
-            <OnEnter><![CDATA[BenillaUnitFrame_OnEnter(this)]]></OnEnter>
-            <OnLeave><![CDATA[BenillaUnitFrame_OnLeave(this)]]></OnLeave>
-            <OnClick><![CDATA[PlayerFrame_OnClick(arg1)]]></OnClick>
-        </Scripts>
-    </Frame>
-
-    <!-- The SELF-menu dropdown host (ref $parentDropDown, PlayerFrame.xml): hidden state-holder
-         only — the list anchors to the player frame by name, never to this. -->
-    <Frame name="PlayerFrameDropDown" parent="PlayerFrame" inherits="UIDropDownMenuTemplate" id="1" hidden="true">
-        <Size><AbsDimension x="10" y="10"/></Size>
-        <Anchors><Anchor point="TOP"><Offset><AbsDimension x="-20" y="-10"/></Offset></Anchor></Anchors>
-        <Scripts>
-            <OnLoad>PlayerFrameDropDown_OnLoad()</OnLoad>
-        </Scripts>
-    </Frame>
-
-    <!-- ref TargetDebuffButtonTemplate (l.26-68): 17×17 icon, 19×19 UI-Debuff-Overlays border
-         (dispel-tinted at update), bottom-right stack count. Sizes are re-set every update by the
-         shrink law (first row only, verbatim ref quirk). -->
-    <Button name="BenillaTargetDebuffTemplate" virtual="true">
-        <Size><AbsDimension x="17" y="17"/></Size>
-        <Layers>
-            <Layer level="ARTWORK">
-                <Texture name="$parentIcon" setAllPoints="true"/>
-            </Layer>
-            <Layer level="OVERLAY">
-                <Texture name="$parentBorder" file="Interface\Buttons\UI-Debuff-Overlays">
-                    <Size><AbsDimension x="19" y="19"/></Size>
-                    <Anchors><Anchor point="CENTER"><Offset><AbsDimension x="0" y="0"/></Offset></Anchor></Anchors>
-                    <TexCoords left="0.296875" right="0.5703125" top="0" bottom="0.515625"/>
-                </Texture>
-                <FontString name="$parentCount" inherits="NumberFontNormalSmall">
-                    <Anchors><Anchor point="BOTTOMRIGHT"><Offset><AbsDimension x="-1" y="0"/></Offset></Anchor></Anchors>
-                </FontString>
-            </Layer>
-        </Layers>
-        <Scripts>
-            <OnEnter>BenillaTargetAuraButton_OnEnter(this, true)</OnEnter>
-            <OnLeave>GameTooltip:Hide()</OnLeave>
-        </Scripts>
-    </Button>
-
-    <!-- ref TargetBuffButtonTemplate (l.69-87): 21×21 icon, no border, no count. -->
-    <Button name="BenillaTargetBuffTemplate" virtual="true">
-        <Size><AbsDimension x="21" y="21"/></Size>
-        <Layers>
-            <Layer level="ARTWORK">
-                <Texture name="$parentIcon" setAllPoints="true"/>
-            </Layer>
-        </Layers>
-        <Scripts>
-            <OnEnter>BenillaTargetAuraButton_OnEnter(this, false)</OnEnter>
-            <OnLeave>GameTooltip:Hide()</OnLeave>
-        </Scripts>
-    </Button>
-
-    <!--
-        TARGET FRAME (ref-TargetFrame.xml). Button 232×100 at UIParent TOPLEFT (250,-4) (l.88-98). The
-        un-mirrored twin of the player frame: portrait window on the RIGHT, bars anchored TOPRIGHT.
-    -->
-    <!-- hidden="true" is a deliberate deviation from the ref (whose TargetFrame starts shown and
-         gets its no-target Hide behind the loading screen, before audio is live): our OnLoad
-         Update runs with audio up, so starting shown would fire OnHide's lost-target sound at
-         every login. Steady-state behavior is identical — Update Shows/Hides on target changes. -->
-    <!-- frameStrata LOW is the ref's own (`TargetFrame.xml` l.88) — one above the player frame's
-         BACKGROUND, still below the MEDIUM panels. Same reasoning as PlayerFrame above. -->
-    <Frame name="TargetFrame" toplevel="true" parent="UIParent" hidden="true" frameStrata="LOW">
-        <Size><AbsDimension x="232" y="100"/></Size>
-        <Anchors>
-            <Anchor point="TOPLEFT" relativePoint="TOPLEFT"><Offset><AbsDimension x="250" y="-4"/></Offset></Anchor>
-        </Anchors>
-        <Layers>
-            <Layer level="BACKGROUND">
-                <!-- Bar trough 119×41 black a=0.5 TOPRIGHT (-106,-22) (ref l.104-116). -->
-                <Texture name="$parentBackground">
-                    <Size><AbsDimension x="119" y="41"/></Size>
-                    <Anchors>
-                        <Anchor point="TOPRIGHT" relativePoint="TOPRIGHT"><Offset><AbsDimension x="-106" y="-22"/></Offset></Anchor>
-                    </Anchors>
-                    <Color r="0" g="0" b="0" a="0.5"/>
-                </Texture>
-                <!-- The level/name plate 119×19 TOPRIGHT (-106,-22) (ref l.117-128) — target only,
-                     untinted (see the header deviation on faction tinting). -->
-                <Texture name="$parentNameBackground" file="Interface\TargetingFrame\UI-TargetingFrame-LevelBackground">
-                    <Size><AbsDimension x="119" y="19"/></Size>
-                    <Anchors>
-                        <Anchor point="TOPRIGHT" relativePoint="TOPRIGHT"><Offset><AbsDimension x="-106" y="-22"/></Offset></Anchor>
-                    </Anchors>
-                </Texture>
-                <!-- Portrait 64×64 TOPRIGHT (-42,-12) (ref l.131-142, BORDER→BACKGROUND for the same
-                     ring-over-portrait layering as the player). -->
-                <Texture name="TargetPortrait">
-                    <Size><AbsDimension x="64" y="64"/></Size>
-                    <Anchors>
-                        <Anchor point="TOPRIGHT" relativePoint="TOPRIGHT"><Offset><AbsDimension x="-42" y="-12"/></Offset></Anchor>
-                    </Anchors>
-                </Texture>
-            </Layer>
-            <!-- The ring art + name/level/dead text live in $parentTextureFrame below (declared AFTER
-                 the bars) so they draw OVER the bar edges — the recessed-bar look. -->
-        </Layers>
-        <Frames>
-            <!-- Health bar 119×12 TOPRIGHT (-106,-41), UI-StatusBar, green (ref l.252-273). -->
-            <StatusBar name="$parentHealthBar" enableMouse="true">
-                <Size><AbsDimension x="119" y="12"/></Size>
-                <Anchors>
-                    <Anchor point="TOPRIGHT" relativePoint="TOPRIGHT"><Offset><AbsDimension x="-106" y="-41"/></Offset></Anchor>
-                </Anchors>
-                <BarTexture file="Interface\TargetingFrame\UI-StatusBar"/>
-                <BarColor r="0.0" g="1.0" b="0.0"/>
-                <Scripts>
-                    <!-- The reference initialises a numerals bar from the BAR'S OWN OnLoad
-                         (PlayerFrame.xml l.300-303, PetFrame.xml l.138/163), never from the parent
-                         with the bar as an argument — `TextStatusBar_Initialize()` takes no
-                         argument in 1.12 and acts on `this`. Ours called it from the parent's
-                         OnLoad, which needed a widened signature and would have broken silently
-                         the day TextStatusBar.xml came off the player's chain (decisions 1793). -->
-                    <OnLoad>if TextStatusBar_Initialize then TextStatusBar_Initialize() end</OnLoad>
-                    <OnEvent>if TextStatusBar_OnEvent then TextStatusBar_OnEvent(arg1, arg2) end</OnEvent>
-                    <OnValueChanged>if TextStatusBar_OnValueChanged then TextStatusBar_OnValueChanged() end</OnValueChanged>
-                    <OnEnter>BenillaUnitFrameBar_OnEnter(self)</OnEnter>
-                    <OnLeave>BenillaUnitFrameBar_OnLeave(self)</OnLeave>
-                    <OnMouseUp>BenillaUnitFrameBar_OnMouseUp(self, arg1)</OnMouseUp>
-                </Scripts>
-            </StatusBar>
-            <!-- Power bar 119×12 TOPRIGHT (-106,-52), UI-StatusBar; color set at runtime (ref l.274-292). -->
-            <StatusBar name="$parentManaBar" enableMouse="true">
-                <Size><AbsDimension x="119" y="12"/></Size>
-                <Anchors>
-                    <Anchor point="TOPRIGHT" relativePoint="TOPRIGHT"><Offset><AbsDimension x="-106" y="-52"/></Offset></Anchor>
-                </Anchors>
-                <BarTexture file="Interface\TargetingFrame\UI-StatusBar"/>
-                <BarColor r="0.0" g="0.0" b="1.0"/>
-                <Scripts>
-                    <!-- The reference initialises a numerals bar from the BAR'S OWN OnLoad
-                         (PlayerFrame.xml l.300-303, PetFrame.xml l.138/163), never from the parent
-                         with the bar as an argument — `TextStatusBar_Initialize()` takes no
-                         argument in 1.12 and acts on `this`. Ours called it from the parent's
-                         OnLoad, which needed a widened signature and would have broken silently
-                         the day TextStatusBar.xml came off the player's chain (decisions 1793). -->
-                    <OnLoad>if TextStatusBar_Initialize then TextStatusBar_Initialize() end</OnLoad>
-                    <OnEvent>if TextStatusBar_OnEvent then TextStatusBar_OnEvent(arg1, arg2) end</OnEvent>
-                    <OnValueChanged>if TextStatusBar_OnValueChanged then TextStatusBar_OnValueChanged() end</OnValueChanged>
-                    <OnEnter>BenillaUnitFrameBar_OnEnter(self)</OnEnter>
-                    <OnLeave>BenillaUnitFrameBar_OnLeave(self)</OnLeave>
-                    <OnMouseUp>BenillaUnitFrameBar_OnMouseUp(self, arg1)</OnMouseUp>
-                </Scripts>
-            </StatusBar>
-            <!-- The ring art + text, over the bars (ref TargetFrameTextureFrame); it draws over the
-                 bar edges because OnLoad pushes the bars one frame level BELOW it (the ref's
-                 SetFrameLevel(bar, textureFrame-1)) — NOT because of where it is declared. See the
-                 LAYERING note at the top of this file. -->
-            <Frame name="$parentTextureFrame">
-                <Size><AbsDimension x="232" y="100"/></Size>
-                <Anchors>
-                    <Anchor point="TOPLEFT" relativePoint="TOPLEFT"><Offset><AbsDimension x="0" y="0"/></Offset></Anchor>
-                </Anchors>
-                <Layers>
-                    <Layer level="BACKGROUND">
-                        <!-- Ring art, UN-mirrored: TexCoords left=0.09375 right=1.0 (ref l.146-151). -->
-                        <Texture name="TargetFrameTexture" file="Interface\TargetingFrame\UI-TargetingFrame">
-                            <Size><AbsDimension x="232" y="100"/></Size>
-                            <Anchors>
-                                <Anchor point="TOPLEFT" relativePoint="TOPLEFT"><Offset><AbsDimension x="0" y="0"/></Offset></Anchor>
-                            </Anchors>
-                            <TexCoords left="0.09375" right="1.0" top="0" bottom="0.78125"/>
-                        </Texture>
-                    </Layer>
-                    <Layer level="ARTWORK">
-                        <!-- The PvP flag icon, 64×64 TOPRIGHT (3,-20) (ref TargetPVPIcon,
-                             ref-TargetFrame.xml l.208-219) — the player's icon mirrored to the
-                             frame's other edge, same law (decision 0646 §4). -->
-                        <Texture name="TargetPVPIcon" hidden="true">
-                            <Size><AbsDimension x="64" y="64"/></Size>
-                            <Anchors>
-                                <Anchor point="TOPRIGHT" relativePoint="TOPRIGHT"><Offset><AbsDimension x="3" y="-20"/></Offset></Anchor>
-                            </Anchors>
-                        </Texture>
-                    </Layer>
-                    <Layer level="OVERLAY">
-                        <!-- Name 100×10 CENTER (-50,19) (ref l.152-163). -->
-                        <FontString name="TargetName" inherits="GameFontNormalSmall" text="Unknown">
-                            <Size><AbsDimension x="100" y="10"/></Size>
-                            <Anchors>
-                                <Anchor point="CENTER" relativePoint="CENTER"><Offset><AbsDimension x="-50" y="19"/></Offset></Anchor>
-                            </Anchors>
-                        </FontString>
-                        <!-- Level number CENTER (63,-16) (ref l.164-172). -->
-                        <FontString name="TargetLevelText" inherits="GameFontNormalSmall">
-                            <Anchors>
-                                <Anchor point="CENTER" relativePoint="CENTER"><Offset><AbsDimension x="63" y="-16"/></Offset></Anchor>
-                            </Anchors>
-                        </FontString>
-                        <!-- The "too high to tell" skull, 16×16 on the level slot (ref
-                             TargetHighLevelTexture, l.184-195): shown for a corpse target or
-                             UnitLevel ≤ 0, replacing the number (TargetFrame_CheckLevel). -->
-                        <Texture name="TargetHighLevelTexture" file="Interface\TargetingFrame\UI-TargetingFrame-Skull">
-                            <Size><AbsDimension x="16" y="16"/></Size>
-                            <Anchors>
-                                <Anchor point="CENTER" relativePoint="CENTER"><Offset><AbsDimension x="63" y="-16"/></Offset></Anchor>
-                            </Anchors>
-                        </Texture>
-                        <!-- DEAD, CENTER (-50,3), shown at zero health (ref l.173-181), spelled
-                             the reference's own way: `text="DEAD"` is a GLOBAL-STRING LOOKUP, so
-                             the word rendered is GlobalStrings.lua l.898's `DEAD = "Dead"` — the
-                             key never reaches the screen. `hidden` like the ToT twin below, a
-                             deliberate divergence: the reference leaves the region shown and
-                             relies on CheckDead landing before the frame does. -->
-                        <FontString name="TargetDeadText" inherits="GameFontNormalSmall" text="DEAD" hidden="true">
-                            <Anchors>
-                                <Anchor point="CENTER" relativePoint="CENTER"><Offset><AbsDimension x="-50" y="3"/></Offset></Anchor>
-                            </Anchors>
-                        </FontString>
-                        <!-- The target's numerals (decision 1146), mirrored from the player's seats
-                             the way the whole frame is: x = −50 against the player's +50, the same
-                             1 px optical drop (1145). 1143 wired these bars and left the regions
-                             out because nothing could ever paint them — 1.12 never makes the target
-                             bars textLockable, so Status Bar Text does not pin them. The HOVER is
-                             what they were waiting for, and it is the reference's behaviour whole:
-                             on the target, the numbers are something you go and look at. -->
-                        <FontString name="TargetFrameHealthBarText" inherits="TextStatusBarText">
-                            <Anchors>
-                                <Anchor point="CENTER" relativePoint="CENTER"><Offset><AbsDimension x="-50" y="3"/></Offset></Anchor>
-                            </Anchors>
-                        </FontString>
-                        <FontString name="TargetFrameManaBarText" inherits="TextStatusBarText">
-                            <Anchors>
-                                <Anchor point="CENTER" relativePoint="CENTER"><Offset><AbsDimension x="-50" y="-9"/></Offset></Anchor>
-                            </Anchors>
-                        </FontString>
-                    </Layer>
-                </Layers>
-            </Frame>
-            <!-- The aura rows (ref l.293-481, names re-based on $parent). Static anchors are the
-                 ref's; the update re-seats Debuff1/6/7/8/11 and Buff1 every pass (the friend swap +
-                 the wrap law). Row 1 debuffs 1-6 (+3 gaps), row 2 debuffs 7-16, buffs below. -->
-            <Button name="$parentDebuff1" inherits="BenillaTargetDebuffTemplate" id="1">
-                <Anchors><Anchor point="TOPLEFT" relativePoint="BOTTOMLEFT"><Offset><AbsDimension x="5" y="32"/></Offset></Anchor></Anchors>
-            </Button>
-            <Button name="$parentDebuff2" inherits="BenillaTargetDebuffTemplate" id="2">
-                <Anchors><Anchor point="LEFT" relativeTo="$parentDebuff1" relativePoint="RIGHT"><Offset><AbsDimension x="3" y="0"/></Offset></Anchor></Anchors>
-            </Button>
-            <Button name="$parentDebuff3" inherits="BenillaTargetDebuffTemplate" id="3">
-                <Anchors><Anchor point="LEFT" relativeTo="$parentDebuff2" relativePoint="RIGHT"><Offset><AbsDimension x="3" y="0"/></Offset></Anchor></Anchors>
-            </Button>
-            <Button name="$parentDebuff4" inherits="BenillaTargetDebuffTemplate" id="4">
-                <Anchors><Anchor point="LEFT" relativeTo="$parentDebuff3" relativePoint="RIGHT"><Offset><AbsDimension x="3" y="0"/></Offset></Anchor></Anchors>
-            </Button>
-            <Button name="$parentDebuff5" inherits="BenillaTargetDebuffTemplate" id="5">
-                <Anchors><Anchor point="LEFT" relativeTo="$parentDebuff4" relativePoint="RIGHT"><Offset><AbsDimension x="3" y="0"/></Offset></Anchor></Anchors>
-            </Button>
-            <Button name="$parentDebuff6" inherits="BenillaTargetDebuffTemplate" id="6">
-                <Anchors><Anchor point="LEFT" relativeTo="$parentDebuff5" relativePoint="RIGHT"><Offset><AbsDimension x="3" y="0"/></Offset></Anchor></Anchors>
-            </Button>
-            <Button name="$parentDebuff7" inherits="BenillaTargetDebuffTemplate" id="7">
-                <Anchors><Anchor point="TOPLEFT" relativeTo="$parentDebuff1" relativePoint="BOTTOMLEFT"><Offset><AbsDimension x="0" y="-3"/></Offset></Anchor></Anchors>
-            </Button>
-            <Button name="$parentDebuff8" inherits="BenillaTargetDebuffTemplate" id="8">
-                <Anchors><Anchor point="LEFT" relativeTo="$parentDebuff7" relativePoint="RIGHT"><Offset><AbsDimension x="3" y="0"/></Offset></Anchor></Anchors>
-            </Button>
-            <Button name="$parentDebuff9" inherits="BenillaTargetDebuffTemplate" id="9">
-                <Anchors><Anchor point="LEFT" relativeTo="$parentDebuff8" relativePoint="RIGHT"><Offset><AbsDimension x="3" y="0"/></Offset></Anchor></Anchors>
-            </Button>
-            <Button name="$parentDebuff10" inherits="BenillaTargetDebuffTemplate" id="10">
-                <Anchors><Anchor point="LEFT" relativeTo="$parentDebuff9" relativePoint="RIGHT"><Offset><AbsDimension x="3" y="0"/></Offset></Anchor></Anchors>
-            </Button>
-            <Button name="$parentDebuff11" inherits="BenillaTargetDebuffTemplate" id="11">
-                <Anchors><Anchor point="LEFT" relativeTo="$parentDebuff10" relativePoint="RIGHT"><Offset><AbsDimension x="3" y="0"/></Offset></Anchor></Anchors>
-            </Button>
-            <Button name="$parentDebuff12" inherits="BenillaTargetDebuffTemplate" id="12">
-                <Anchors><Anchor point="LEFT" relativeTo="$parentDebuff11" relativePoint="RIGHT"><Offset><AbsDimension x="3" y="0"/></Offset></Anchor></Anchors>
-            </Button>
-            <Button name="$parentDebuff13" inherits="BenillaTargetDebuffTemplate" id="13">
-                <Anchors><Anchor point="LEFT" relativeTo="$parentDebuff12" relativePoint="RIGHT"><Offset><AbsDimension x="3" y="0"/></Offset></Anchor></Anchors>
-            </Button>
-            <Button name="$parentDebuff14" inherits="BenillaTargetDebuffTemplate" id="14">
-                <Anchors><Anchor point="LEFT" relativeTo="$parentDebuff13" relativePoint="RIGHT"><Offset><AbsDimension x="3" y="0"/></Offset></Anchor></Anchors>
-            </Button>
-            <Button name="$parentDebuff15" inherits="BenillaTargetDebuffTemplate" id="15">
-                <Anchors><Anchor point="LEFT" relativeTo="$parentDebuff14" relativePoint="RIGHT"><Offset><AbsDimension x="3" y="0"/></Offset></Anchor></Anchors>
-            </Button>
-            <Button name="$parentDebuff16" inherits="BenillaTargetDebuffTemplate" id="16">
-                <Anchors><Anchor point="LEFT" relativeTo="$parentDebuff15" relativePoint="RIGHT"><Offset><AbsDimension x="3" y="0"/></Offset></Anchor></Anchors>
-            </Button>
-            <Button name="$parentBuff1" inherits="BenillaTargetBuffTemplate" id="1">
-                <Anchors><Anchor point="TOPLEFT" relativeTo="$parentDebuff1" relativePoint="BOTTOMLEFT"><Offset><AbsDimension x="0" y="-2"/></Offset></Anchor></Anchors>
-            </Button>
-            <Button name="$parentBuff2" inherits="BenillaTargetBuffTemplate" id="2">
-                <Anchors><Anchor point="LEFT" relativeTo="$parentBuff1" relativePoint="RIGHT"><Offset><AbsDimension x="3" y="0"/></Offset></Anchor></Anchors>
-            </Button>
-            <Button name="$parentBuff3" inherits="BenillaTargetBuffTemplate" id="3">
-                <Anchors><Anchor point="LEFT" relativeTo="$parentBuff2" relativePoint="RIGHT"><Offset><AbsDimension x="3" y="0"/></Offset></Anchor></Anchors>
-            </Button>
-            <Button name="$parentBuff4" inherits="BenillaTargetBuffTemplate" id="4">
-                <Anchors><Anchor point="LEFT" relativeTo="$parentBuff3" relativePoint="RIGHT"><Offset><AbsDimension x="3" y="0"/></Offset></Anchor></Anchors>
-            </Button>
-            <Button name="$parentBuff5" inherits="BenillaTargetBuffTemplate" id="5">
-                <Anchors><Anchor point="LEFT" relativeTo="$parentBuff4" relativePoint="RIGHT"><Offset><AbsDimension x="3" y="0"/></Offset></Anchor></Anchors>
-            </Button>
-        </Frames>
-        <Scripts>
-            <OnLoad><![CDATA[BenillaUnitFrame_OnLoad(this, "target")]]></OnLoad>
-            <OnEvent><![CDATA[UnitFrame_OnEvent(event)]]></OnEvent>
-            <OnEnter><![CDATA[BenillaUnitFrame_OnEnter(this)]]></OnEnter>
-            <OnLeave><![CDATA[BenillaUnitFrame_OnLeave(this)]]></OnLeave>
-            <!-- The select/deselect pair rides the frame's visibility, exactly the ref
-                 (TargetFrame_OnShow/OnHide, TargetFrame.lua l.104-117). In 5875 data all three
-                 select kits resolve to the same iSelectTarget.wav — the reaction branch is
-                 data-plumbing fidelity, not an audible difference. -->
-            <OnShow><![CDATA[
-                if UnitIsEnemy("target", "player") then
-                    PlaySound("igCreatureAggroSelect")
-                elseif UnitIsFriend("player", "target") then
-                    PlaySound("igCharacterNPCSelect")
-                else
-                    PlaySound("igCreatureNeutralSelect")
-                end
-            ]]></OnShow>
-            <!-- ref TargetFrame_OnHide: the lost-target sound + close any open unit menu (a
-                 cleared target must not leave its menu acting on a stale unit). -->
-            <OnHide><![CDATA[
-                PlaySound("INTERFACESOUND_LOSTTARGETUNIT")
-                CloseDropDownMenus()
-            ]]></OnHide>
-            <!-- The target-of-target reconcile (decision 1576, ref TargetFrame_OnUpdate): one
-                 boolean compare, and only while a target exists. See its note below. -->
-            <OnUpdate><![CDATA[TargetFrame_OnUpdate()]]></OnUpdate>
-            <OnClick><![CDATA[TargetFrame_OnClick(arg1)]]></OnClick>
-        </Scripts>
-    </Frame>
-
-    <!-- The target-menu dropdown host (ref $parentDropDown, TargetFrame.xml): hidden
-         state-holder only, like the player's above. -->
-    <Frame name="TargetFrameDropDown" parent="TargetFrame" inherits="UIDropDownMenuTemplate" id="1" hidden="true">
-        <Size><AbsDimension x="10" y="10"/></Size>
-        <Anchors><Anchor point="TOP"><Offset><AbsDimension x="-20" y="-10"/></Offset></Anchor></Anchors>
-        <Scripts>
-            <OnLoad>TargetFrameDropDown_OnLoad()</OnLoad>
-        </Scripts>
-    </Frame>
-
-    <!--
-        THE TARGET-OF-TARGET FRAME (decision 1576). The 93×45 satellite at the target frame's
-        bottom-right: who the unit you have selected is fighting. Geometry, art and law are
-        MEASURED off the reference (ref-TargetFrame.xml l.515-690, ref-TargetFrame.lua l.494-585);
-        the code is our own, on this file's snapshot → Unit* → event data flow.
-
-        THE TOKEN IS THE SLICE. `"targettarget"` is 1.12's own token grammar and our resolver
-        already RECOGNISED it (the `target` prefix — benilla-ui unit/mod.rs); it simply never named
-        a unit, because nothing fed one. The app now does: the selected unit's own
-        `UNIT_FIELD_TARGET`, one hop through the guid→entity index (ui_unit.rs), with the aura list
-        (ui_aura.rs) and the portrait booth (portrait/mod.rs) following the same hop. Everything
-        below is then ordinary FrameXML over an ordinary unit token.
-
-        DRIVEN BY EVENTS, NOT BY A POLL. The reference calls `TargetofTarget_Update()` from this
-        frame's own OnUpdate, every frame, unconditionally — it has no other way to notice, since
-        its engine fires no UNIT_* event for this token. Ours fires them (the feed diffs the
-        snapshot and fires per field, exactly as it does for `"target"`), so the repaint rides the
-        events. What events cannot carry is a token going AWAY — the feed clears it silently, by
-        the same convention `"target"` uses — and that is precisely what the reference's own
-        reconcile line covers (`TargetFrame_OnUpdate`, ref l.256-260): one boolean compare per
-        frame, on a frame that only ticks while you have a target. That line we keep.
-
-        DEVIATIONS, noted:
-        - No hover tooltip and no right-click menu. The reference gives this frame neither — its
-          Scripts are OnLoad/OnEvent/OnUpdate/OnClick and nothing else — so neither is built here.
-          The four debuff buttons do carry the reference's own aura tooltip.
-        - The five display modes are a PREDICATE, not the reference's ladder. ref l.505-528 tests
-          them as an if/elseif chain in which the solo leg (state "3") calls neither Show nor Hide
-          when you are in a raid: the frame keeps whatever state it had, which is a leaked state,
-          not a rule. `TargetofTarget_ModeAllows` answers the question the five modes ask.
-        - A powerless unit hides its mana bar, this file's convention on every frame; the
-          reference leaves an empty 0/0 rail drawn.
-        - `TargetofTargetHealthCheck` guards its own divide. The reference divides by
-          `UnitManaMax`'s sibling `unitHPMax` with no zero test.
-    -->
-    <!-- The debuff button — ref TargetofTargetBuffButtonTemplate (TargetFrame.xml l.4-27): the
-         party template shrunk to 12×12 with a 13×13 border, which is why the reference re-sets
-         both in an OnLoad rather than authoring them. We author them. No stack-count region: the
-         reference's party template has none, and at 12 px a numeral is not readable anyway. -->
-    <Button name="BenillaTargetofTargetDebuffTemplate" virtual="true" hidden="true">
-        <Size><AbsDimension x="12" y="12"/></Size>
-        <Layers>
-            <Layer level="ARTWORK">
-                <Texture name="$parentIcon" setAllPoints="true"/>
-            </Layer>
-            <Layer level="OVERLAY">
-                <Texture name="$parentBorder" file="Interface\Buttons\UI-Debuff-Overlays">
-                    <Size><AbsDimension x="13" y="13"/></Size>
-                    <Anchors><Anchor point="CENTER"><Offset><AbsDimension x="0" y="0"/></Offset></Anchor></Anchors>
-                    <TexCoords left="0.296875" right="0.5703125" top="0" bottom="0.515625"/>
-                </Texture>
-            </Layer>
-        </Layers>
-        <Scripts>
-            <OnEnter><![CDATA[
-                if GameTooltip then
-                    GameTooltip:SetOwner(this, "ANCHOR_RIGHT")
-                    GameTooltip:SetUnitDebuff("targettarget", this:GetID())
-                end
-            ]]></OnEnter>
-            <OnLeave>GameTooltip:Hide()</OnLeave>
-        </Scripts>
-    </Button>
-
-    <Script><![CDATA[
-        -- The two saved settings (ref UIOptionsFrame.lua l.116-119), with the reference's own
-        -- defaults: the frame ships OFF, and its mode ships at "always". They are saved-variable
-        -- globals rather than CVars because that is what they are in 1.12 — the Interface panel's
-        -- `uvar` store (OptionsFrame.xml's three-store note), and RegisterForSave is what persists
-        -- them into benilla-config (saved.rs).
-        SHOW_TARGET_OF_TARGET = "0"
-        RegisterForSave("SHOW_TARGET_OF_TARGET")
-        SHOW_TARGET_OF_TARGET_STATE = "5"
-        RegisterForSave("SHOW_TARGET_OF_TARGET_STATE")
-
-        -- Does the group state allow the frame right now? The five modes, in the reference's own
-        -- numbering (its dropdown writes these strings, and OPTION_TOOLTIP_TARGETOFTARGET1..5
-        -- describes them in this order): 1 raid, 2 party, 3 solo, 4 party or raid, 5 always.
-        -- Written as a predicate rather than the reference's if/elseif ladder — see the DEVIATIONS
-        -- note above for the leaked state that ladder has in its solo leg. LOCAL: the reference has
-        -- no such function, and inventing a global for it would put a name in `_G` that no addon
-        -- written against 1.12 can expect (the `Benilla*` prefix is for the ones we must expose).
-        local function TargetofTarget_ModeAllows()
-            local mode = SHOW_TARGET_OF_TARGET_STATE
-            local raid = GetNumRaidMembers()
-            local party = GetNumPartyMembers()
-            if mode == "1" then return raid > 0 end
-            if mode == "2" then return party > 0 and raid == 0 end
-            if mode == "3" then return raid == 0 and party == 0 end
-            if mode == "4" then return raid > 0 or party > 0 end
-            if mode == "5" then return true end
-            return false
-        end
-
-        -- The visibility law + the repaint (ref TargetofTarget_Update, l.503-541). Four gates
-        -- besides the switch and the mode, all the reference's: there must BE a target, it must
-        -- have a target, it must not be YOU (your own target's target is your own target — the
-        -- frame would restate the frame it hangs off), and it must be alive.
-        function TargetofTarget_Update()
-            local frame = TargetofTargetFrame
-            local was = frame:IsShown()
-            local show = SHOW_TARGET_OF_TARGET == "1"
-                and UnitExists("target")
-                and UnitExists("targettarget")
-                and not UnitIsUnit("player", "target")
-                and UnitHealth("target") > 0
-                and TargetofTarget_ModeAllows()
-            if show then
-                frame:Show()
-                BenillaUnitFrame_PaintBars(frame.healthbar, frame.manabar, "targettarget")
-                TargetofTargetName:SetText(UnitName("targettarget") or "")
-                TargetofTarget_CheckDead()
-                -- The reference's own line (l.536), and it is not redundant with the health
-                -- check's tint: that one only ever touches a PLAYER's portrait, so a creature
-                -- inherits whatever alpha the last player left behind without this.
-                TargetofTargetPortrait:SetAlpha(1.0)
-                BenillaTargetofTarget_UpdateDebuffs()
-            else
-                frame:Hide()
-            end
-            -- The target's OWN aura rows wrap at 5 instead of 6 while this frame stands beside
-            -- them (BenillaTargetAuras_Update), so a change of shown state re-lays them out. The
-            -- reference re-runs them on the SHOW leg only (l.534) and never on the hide, which
-            -- leaves the rows wrapped short after the frame goes away.
-            if frame:IsShown() ~= was and UnitExists("target") then
-                BenillaTargetAuras_Update()
-            end
-        end
-
-        -- ref TargetofTarget_CheckDead (l.559-567): the DEAD word over a dimmed trough. The
-        -- connected test is the reference's and it is what tells "dead" from "linkdead" —
-        -- a disconnected player reads 0 health here and is not dead.
-        function TargetofTarget_CheckDead()
-            local down = UnitHealth("targettarget") <= 0 and UnitIsConnected("targettarget")
-            TargetofTargetBackground:SetAlpha(down and 0.9 or 1)
-            if down then
-                TargetofTargetDeadText:Show()
-            else
-                TargetofTargetDeadText:Hide()
-            end
-        end
-
-        -- The four readings a PLAYER's portrait can carry here (ref TargetofTargetHealthCheck's
-        -- own four SetVertexColor calls, l.573-583): a corpse greys, a released ghost goes blue,
-        -- a fifth of health or less runs red, and anything else is untinted.
-        local TOT_PORTRAIT_TINT = {
-            dead  = { r = 0.35, g = 0.35, b = 0.35 },
-            ghost = { r = 0.2,  g = 0.2,  b = 0.75 },
-            hurt  = { r = 1.0,  g = 0.0,  b = 0.0 },
-            alive = { r = 1.0,  g = 1.0,  b = 1.0 },
-        }
-
-        -- ref TargetofTargetHealthCheck (l.569-585), the health bar's OnValueChanged: the
-        -- portrait tints with the unit's state — grey dead, blue ghost, red under a fifth of its
-        -- health, white otherwise. PLAYERS ONLY, which is the reference's gate and not an
-        -- oversight: a creature's portrait carries no such reading anywhere in 1.12.
-        function TargetofTargetHealthCheck()
-            if not UnitIsPlayer("targettarget") then return end
-            local bar = this
-            local _, maxHP = bar:GetMinMaxValues()
-            local percent = 0
-            if maxHP > 0 then
-                percent = bar:GetValue() / maxHP
-            end
-            bar:GetParent().unitHPPercent = percent
-            -- The reading, then one paint. Priority is the reference's ladder: dead outranks
-            -- ghost outranks hurt, and anything else is untinted.
-            local tint = TOT_PORTRAIT_TINT.alive
-            if UnitIsDead("targettarget") then
-                tint = TOT_PORTRAIT_TINT.dead
-            elseif UnitIsGhost("targettarget") then
-                tint = TOT_PORTRAIT_TINT.ghost
-            elseif percent > 0 and percent <= 0.2 then
-                tint = TOT_PORTRAIT_TINT.hurt
-            end
-            TargetofTargetPortrait:SetVertexColor(tint.r, tint.g, tint.b, 1.0)
-        end
-
-        -- The four debuff buttons (ref calls RefreshBuffs(this, 0, "targettarget"), BuffFrame.lua
-        -- l.262-312, over MAX_PARTY_DEBUFFS = 4). Same shape as the pet frame's row, plus the
-        -- dispel tint the party/pet rows do not carry — RefreshBuffs colours its border by
-        -- debuffType exactly as the target frame's row does.
-        function BenillaTargetofTarget_UpdateDebuffs()
-            for i = 1, 4 do
-                local button = getglobal("TargetofTargetFrameDebuff" .. i)
-                local _, icon, _, debuffType = UnitDebuff("targettarget", i)
-                if icon then
-                    getglobal(button:GetName() .. "Icon"):SetTexture(icon)
-                    local color = DebuffTypeColor[debuffType] or DebuffTypeColor["none"]
-                    getglobal(button:GetName() .. "Border"):SetVertexColor(color.r, color.g, color.b)
-                    button:Show()
-                else
-                    button:Hide()
-                end
-            end
-        end
-
-        function TargetofTarget_OnLoad()
-            local frame = this
-            frame.unit = "targettarget"
-            frame.healthbar = TargetofTargetHealthBar
-            frame.manabar = TargetofTargetManaBar
-            -- The recessed-bar look, the same mechanism every frame in this file uses (decision
-            -- 0884): the bars one frame level BELOW the art's TextureFrame, because the draw layer
-            -- is bucket-wide and the frame level is the one key term above it. The reference
-            -- spends its level the other way round (RaiseFrameLevel on the TextureFrame); same
-            -- ordering, and ours matches its siblings here.
-            local level = TargetofTargetTextureFrame:GetFrameLevel()
-            frame.healthbar:SetFrameLevel(level - 1)
-            frame.manabar:SetFrameLevel(level - 1)
-            -- The live model portrait, bound once by token (see BenillaUnitFrame_OnLoad's note):
-            -- the app keeps this slot's bake current, and it only bakes at all while this frame is
-            -- on screen (portrait/mod.rs's `"targettarget"` arm).
-            SetPortraitTexture(TargetofTargetPortrait, "targettarget")
-            -- Every event the shown frame's paint reads. The `"target"` half is not incidental:
-            -- the visibility law gates on the TARGET being alive, so the target's own health has
-            -- to reach this frame too.
-            for _, wire in ipairs({
-                "PLAYER_ENTERING_WORLD", "PLAYER_TARGET_CHANGED", "PARTY_MEMBERS_CHANGED",
-                "RAID_ROSTER_UPDATE", "UNIT_HEALTH", "UNIT_MAXHEALTH", "UNIT_POWER_UPDATE",
-                "UNIT_MAXPOWER", "UNIT_DISPLAYPOWER", "UNIT_NAME_UPDATE", "UNIT_AURA",
-            }) do
-                frame:RegisterEvent(wire)
-            end
-            frame:EnableMouse(true)
-            TargetofTarget_Update()
-        end
-
-        -- Every UNIT_* event this frame registers names a unit in arg1, and exactly two of them
-        -- concern it: its own, and the target whose health gates its visibility. Everything else
-        -- (a party member's tick, the player's own) is somebody else's update.
-        function TargetofTarget_OnEvent(event)
-            if string.sub(event, 1, 5) == "UNIT_"
-                and arg1 ~= "targettarget" and arg1 ~= "target" then
-                return
-            end
-            TargetofTarget_Update()
-        end
-
-        -- ref TargetofTarget_OnClick (l.543-557).
-        function TargetofTarget_OnClick(button)
-            local armed = SpellIsTargeting()
-            if button ~= "LeftButton" then
-                -- Right-click cancels an armed spell and does nothing else: unlike the player,
-                -- target and pet frames, this one has no unit menu in the reference.
-                if armed and button == "RightButton" then SpellStopTargeting() end
-                return
-            end
-            -- Most specific first, the pet frame's order: an armed spell binds to the unit, then
-            -- a held item drops on it, and with an empty cursor the click SELECTS it — which is
-            -- the whole point of the frame, and the one leg the target frame's click does not have.
-            if armed then
-                SpellTargetUnit("targettarget")
-                return
-            end
-            if CursorHasItem() then
-                DropItemOnUnit("targettarget")
-                return
-            end
-            TargetUnit("targettarget")
-        end
-
-        -- ref TargetFrame_OnUpdate (l.256-260) — the one thing the event feed cannot carry. A
-        -- token that goes away is CLEARED, not announced (ui_unit.rs: "clearing a token isn't a
-        -- UNIT_* event"), so this reconciles the frame's shown state against the token's existence
-        -- once per frame. It runs only while the target frame itself is shown, which is only while
-        -- you have a target — the cost is one compare, and it is the reference's own line.
-        -- Both sides are normalised to booleans on purpose. They happen to agree today (a frame's
-        -- IsShown answers true/false, and so does UnitExists), but a REGION's IsShown answers the
-        -- 1.12 shape of 1/nil, and the day UnitExists is moved onto it a bare `~=` here would be
-        -- true forever — a silent per-frame full repaint, which is the one thing this line exists
-        -- to avoid.
-        function TargetFrame_OnUpdate()
-            local shown = TargetofTargetFrame:IsShown() and true or false
-            local exists = UnitExists("targettarget") and true or false
-            if shown ~= exists then
-                TargetofTarget_Update()
-            end
-        end
-    ]]></Script>
-
-    <!-- 93×45 at the target frame's BOTTOMRIGHT (-35,-10) — ref TargetFrame.xml l.515-525. A
-         Frame, not the reference's Button: every unit frame in this file is one, and this engine
-         dispatches OnClick on a mouse-enabled frame (see TargetFrame/PetFrame above). -->
-    <Frame name="TargetofTargetFrame" enableMouse="true" toplevel="true" parent="TargetFrame" hidden="true" frameStrata="LOW">
-        <Size><AbsDimension x="93" y="45"/></Size>
-        <Anchors>
-            <Anchor point="BOTTOMRIGHT" relativePoint="BOTTOMRIGHT"><Offset><AbsDimension x="-35" y="-10"/></Offset></Anchor>
-        </Anchors>
-        <Layers>
-            <Layer level="BACKGROUND">
-                <!-- The bars' black trough, 46×15 BOTTOMLEFT (42,13) (ref l.528-541). Its alpha is
-                     what CheckDead dims. -->
-                <Texture name="TargetofTargetBackground">
-                    <Size><AbsDimension x="46" y="15"/></Size>
-                    <Anchors>
-                        <Anchor point="BOTTOMLEFT" relativePoint="BOTTOMLEFT"><Offset><AbsDimension x="42" y="13"/></Offset></Anchor>
-                    </Anchors>
-                    <Color r="0" g="0" b="0" a="0.5"/>
-                </Texture>
-                <!-- Portrait 35×35 TOPLEFT (6,-6) (ref l.543-556, BORDER→BACKGROUND for the same
-                     ring-over-portrait layering the player and target frames use). -->
-                <Texture name="TargetofTargetPortrait">
-                    <Size><AbsDimension x="35" y="35"/></Size>
-                    <Anchors>
-                        <Anchor point="TOPLEFT" relativePoint="TOPLEFT"><Offset><AbsDimension x="6" y="-6"/></Offset></Anchor>
-                    </Anchors>
-                </Texture>
-            </Layer>
-        </Layers>
-        <Frames>
-            <!-- Health bar 46×7 TOPRIGHT (-2,-15), UI-StatusBar, green (ref l.593-611). -->
-            <StatusBar name="TargetofTargetHealthBar">
-                <Size><AbsDimension x="46" y="7"/></Size>
-                <Anchors>
-                    <Anchor point="TOPRIGHT" relativePoint="TOPRIGHT"><Offset><AbsDimension x="-2" y="-15"/></Offset></Anchor>
-                </Anchors>
-                <BarTexture file="Interface\TargetingFrame\UI-StatusBar"/>
-                <BarColor r="0.0" g="1.0" b="0.0"/>
-                <Scripts>
-                    <OnValueChanged>TargetofTargetHealthCheck()</OnValueChanged>
-                </Scripts>
-            </StatusBar>
-            <!-- Power bar 46×7 TOPRIGHT (-2,-23); colour set at runtime (ref l.612-625). -->
-            <StatusBar name="TargetofTargetManaBar">
-                <Size><AbsDimension x="46" y="7"/></Size>
-                <Anchors>
-                    <Anchor point="TOPRIGHT" relativePoint="TOPRIGHT"><Offset><AbsDimension x="-2" y="-23"/></Offset></Anchor>
-                </Anchors>
-                <BarTexture file="Interface\TargetingFrame\UI-StatusBar"/>
-                <BarColor r="0.0" g="0.0" b="1.0"/>
-            </StatusBar>
-            <!-- The plate art + text, over the bars (ref TargetofTargetTextureFrame l.558-591) —
-                 it draws over the bar edges because OnLoad pushes the bars one frame level below
-                 it, exactly as on the player and target frames. -->
-            <Frame name="TargetofTargetTextureFrame">
-                <Size><AbsDimension x="93" y="45"/></Size>
-                <Anchors>
-                    <Anchor point="TOPLEFT" relativePoint="TOPLEFT"><Offset><AbsDimension x="0" y="0"/></Offset></Anchor>
-                </Anchors>
-                <Layers>
-                    <Layer level="BACKGROUND">
-                        <!-- The small plate, its own art file. The TexCoords are the reference's
-                             (l.561-563) and they cut the 128×64 file to exactly this frame's
-                             93×45: 0.015625..0.7265625 is x 2..93, 0..0.703125 is y 0..45. -->
-                        <Texture name="TargetofTargetTexture" file="Interface\TargetingFrame\UI-TargetofTargetFrame">
-                            <Size><AbsDimension x="93" y="45"/></Size>
-                            <Anchors>
-                                <Anchor point="TOPLEFT" relativePoint="TOPLEFT"><Offset><AbsDimension x="0" y="0"/></Offset></Anchor>
-                            </Anchors>
-                            <TexCoords left="0.015625" right="0.7265625" top="0" bottom="0.703125"/>
-                        </Texture>
-                    </Layer>
-                    <Layer level="OVERLAY">
-                        <!-- Name 100×10 BOTTOMLEFT (42,2) (ref l.564-576). -->
-                        <FontString name="TargetofTargetName" inherits="GameFontNormalSmall" justifyH="LEFT">
-                            <Size><AbsDimension x="100" y="10"/></Size>
-                            <Anchors>
-                                <Anchor point="BOTTOMLEFT" relativePoint="BOTTOMLEFT"><Offset><AbsDimension x="42" y="2"/></Offset></Anchor>
-                            </Anchors>
-                        </FontString>
-                        <!-- DEAD, over the trough, CENTER (15,1) (ref l.576-587). -->
-                        <FontString name="TargetofTargetDeadText" inherits="GameFontNormalSmall" text="DEAD" hidden="true">
-                            <Anchors>
-                                <Anchor point="CENTER" relativePoint="CENTER"><Offset><AbsDimension x="15" y="1"/></Offset></Anchor>
-                            </Anchors>
-                        </FontString>
-                    </Layer>
-                </Layers>
-            </Frame>
-            <!-- The four debuffs, ref geometry (l.626-663): the first hangs off the frame's
-                 TOPRIGHT, then a 2×2 block. -->
-            <Button name="$parentDebuff1" inherits="BenillaTargetofTargetDebuffTemplate" id="1">
-                <Anchors>
-                    <Anchor point="TOPLEFT" relativePoint="TOPRIGHT"><Offset><AbsDimension x="4" y="-10"/></Offset></Anchor>
-                </Anchors>
-            </Button>
-            <Button name="$parentDebuff2" inherits="BenillaTargetofTargetDebuffTemplate" id="2">
-                <Anchors>
-                    <Anchor point="LEFT" relativeTo="TargetofTargetFrameDebuff1" relativePoint="RIGHT"><Offset><AbsDimension x="1" y="0"/></Offset></Anchor>
-                </Anchors>
-            </Button>
-            <Button name="$parentDebuff3" inherits="BenillaTargetofTargetDebuffTemplate" id="3">
-                <Anchors>
-                    <Anchor point="TOPLEFT" relativeTo="TargetofTargetFrameDebuff1" relativePoint="BOTTOMLEFT"><Offset><AbsDimension x="0" y="-1"/></Offset></Anchor>
-                </Anchors>
-            </Button>
-            <Button name="$parentDebuff4" inherits="BenillaTargetofTargetDebuffTemplate" id="4">
-                <Anchors>
-                    <Anchor point="LEFT" relativeTo="TargetofTargetFrameDebuff3" relativePoint="RIGHT"><Offset><AbsDimension x="1" y="0"/></Offset></Anchor>
-                </Anchors>
-            </Button>
-        </Frames>
-        <Scripts>
-            <OnLoad><![CDATA[TargetofTarget_OnLoad()]]></OnLoad>
-            <OnEvent><![CDATA[TargetofTarget_OnEvent(event)]]></OnEvent>
-            <OnClick><![CDATA[TargetofTarget_OnClick(arg1)]]></OnClick>
-        </Scripts>
-    </Frame>
-
-    <!--
-        THE PET FRAME (decision 0990). Geometry and art are MEASURED off ref PetFrame.xml +
-        PetFrame.lua and the behaviour is theirs; the code is our own. 128×53 parented to
-        the player frame at TOPLEFT (80,-60) — a static anchor, deliberately: the reference does not
-        list PetFrame in UIPARENT_MANAGED_FRAME_POSITIONS at all, because it rides its parent.
-
-        The art is the SMALL targeting frame, and it has two states the ref swaps at runtime
-        (PetFrame.lua's Update): `UI-SmallTargetingFrame` when the pet has a power bar, `-NoMana`
-        when it has none. That is not decoration — a warlock's imp has mana and a hunter's boar has
-        focus, but a skeleton has neither, and the plain art draws a mana rail with nothing in it.
-
-        HAPPINESS is no longer deferred — decision 1005 built it, off the carve 0990 was waiting
-        for. `GetPetHappiness 0x4be900` returns a bucket the CLIENT has already computed from
-        PetPersonality.dbc's own three thresholds, so nothing here is derived from vmangos and
-        0988's warning was answered rather than dodged. Its three siblings (`GetPetLoyalty`,
-        `GetPetTrainingPoints`, `GetPetExperience`) landed with it.
-
-        The PET RIGHT-CLICK MENU is no longer deferred either — decision 1066 built the last of
-        the five things it was waiting on (the pet paper doll, the fifth, landed as 1057). The
-        frame's non-left-click arm opens PetFrameDropDown below; the rows, their fork and their
-        dialogs are UnitPopup.xml's.
-
-        STILL DEFERRED, with its reason:
-        - PartyMemberBuffTooltip on hover (the ref's OnEnter panel): it belongs to the party
-          frames' own deferred buff panel, not here.
-    -->
-    <Script><![CDATA[
-        function PetFrame_OnLoad()
-            local frame = this
-            frame.portrait  = PetPortrait
-            frame.healthbar = PetFrameHealthBar
-            frame.manabar   = PetFrameManaBar
-            frame.nameText  = PetName
-            -- The recessed-bar look, the same mechanism the player/target/party frames use
-            -- (decision 0884): push the bars one frame level BELOW the art's TextureFrame, because
-            -- the draw layer is bucket-wide and the frame level is the one key term above it.
-            local level = PetFrameTextureFrame:GetFrameLevel()
-            frame.healthbar:SetFrameLevel(level - 1)
-            frame.manabar:SetFrameLevel(level - 1)
-            -- The pet's numerals, textLockable like the ref's (PetFrame.xml l.139/164; 1143).
-            -- `TextStatusBar_Initialize` is NOT called here any more — each bar calls it from its
-            -- own OnLoad, the reference's way (PetFrame.xml l.138/163).
-            if SetTextStatusBarText then -- engine tests load file subsets
-                SetTextStatusBarText(frame.healthbar, PetFrameHealthBarText)
-                SetTextStatusBarText(frame.manabar, PetFrameManaBarText)
-                frame.healthbar.textLockable = 1
-                frame.manabar.textLockable = 1
-            end
-            -- The pet's bars hover for their numbers, but hand nothing on: the pet frame has no
-            -- OnEnter of its own, and its click is its own handler (1146).
-            frame.healthbar.ownerClick = PetFrame_OnClick
-            frame.manabar.ownerClick = PetFrame_OnClick
-            frame.attackModeCounter = 0
-            frame.attackModeSign = -1
-            frame:RegisterEvent("PLAYER_ENTERING_WORLD")
-            frame:RegisterEvent("UNIT_PET")
-            frame:RegisterEvent("UNIT_AURA")
-            frame:RegisterEvent("UNIT_HEALTH")
-            frame:RegisterEvent("UNIT_MAXHEALTH")
-            frame:RegisterEvent("UNIT_POWER_UPDATE")
-            frame:RegisterEvent("UNIT_MAXPOWER")
-            frame:RegisterEvent("UNIT_DISPLAYPOWER")
-            frame:RegisterEvent("UNIT_NAME_UPDATE")
-            frame:RegisterEvent("PET_ATTACK_START")
-            frame:RegisterEvent("PET_ATTACK_STOP")
-            frame:RegisterEvent("UNIT_HAPPINESS")
-            frame:EnableMouse(true)
-            PetFrame_Update()
-        end
-
-        -- ref PetFrame_OnEvent, with both of its argument gates kept: UNIT_PET names the OWNER
-        -- ("player" — wow-re §9 carves the arg), every other UNIT_* names the pet itself. Getting
-        -- those backwards is how a pet frame ends up repainting off the player's health.
-        function PetFrame_OnEvent(event)
-            local frame = this
-            if event == "PET_ATTACK_START" then
-                PetAttackModeTexture:SetVertexColor(1.0, 1.0, 1.0, 1.0)
-                PetAttackModeTexture:Show()
-                return
-            elseif event == "PET_ATTACK_STOP" then
-                PetAttackModeTexture:Hide()
-                return
-            elseif event == "UNIT_HAPPINESS" then
-                -- The ref's own last arm: repaint the icon alone, not the whole frame.
-                PetFrame_SetHappiness()
-                return
-            elseif event == "UNIT_PET" then
-                if arg1 ~= "player" then return end
-            elseif string.sub(event, 1, 5) == "UNIT_" and arg1 ~= "pet" then
-                return
-            end
-            PetFrame_Update()
-        end
-
-        function PetFrame_Update()
-            local frame = this
-            if not UnitExists("pet") then
-                frame:Hide()
-                return
-            end
-            frame:Show()
-            SetPortraitTexture(frame.portrait, "pet")
-            frame.nameText:SetText(UnitName("pet") or "")
-
-            -- The ref's art swap (PetFrame.lua's Update): a powerless pet wears the -NoMana plate,
-            -- which has no mana rail to leave empty. Which plate is exactly the shared paint's
-            -- return — the pet is the only frame here whose art carries that distinction.
-            if BenillaUnitFrame_PaintBars(frame.healthbar, frame.manabar, "pet") then
-                PetFrameTexture:SetTexture("Interface\\TargetingFrame\\UI-SmallTargetingFrame")
-            else
-                PetFrameTexture:SetTexture("Interface\\TargetingFrame\\UI-SmallTargetingFrame-NoMana")
-            end
-
-            BenillaPetFrame_UpdateDebuffs()
-            PetFrame_SetHappiness()
-        end
-
-        -- ── The happiness face (decision 1005; ref PetFrame_SetHappiness, PetFrame.lua l.132-156)
-        --
-        -- `Interface\PetPaperDollFrame\UI-PetHappiness` is one row of three faces, and each cut is
-        -- a MEASURED value off that file. The buckets run RIGHT to left across the strip — bucket
-        -- 1 (unhappy) takes the rightmost cut and bucket 3 (happy) sits at x=0 — which is why the
-        -- left edges below descend as the index climbs. A bucket outside 1..3 selects no cell at
-        -- all and the icon keeps whatever face it was already wearing, deliberately: see the note
-        -- on bucket 0 below.
-        local PET_HAPPINESS_CELL = {
-            { 0.375, 0.5625, 0, 0.359375 },
-            { 0.1875, 0.375, 0, 0.359375 },
-            { 0, 0.1875, 0, 0.359375 },
-        }
-
-        -- `GetPetHappiness` hands back a PRE-BUCKETED 1/2/3 — the client does the thresholding
-        -- against PetPersonality.dbc, not this function — plus the two numbers that bucket
-        -- selects. Three things here are load-bearing and each is the reference's own:
-        --   * the hide test is on the bucket being ABSENT, not on it being zero, so a bucket of
-        --     **0** (truthy in Lua) leaves the icon SHOWING with whatever texcoords it had.
-        --     Testing `happiness == 0` or coercing 0 to nil would hide a frame the reference shows.
-        --   * only a HUNTER's pet has a face at all — `HasPetUI`'s second return is the whole gate,
-        --     and its first return is nothing to do with this frame.
-        --   * the loyalty line is chosen by the SIGN of loyaltyRate, which is why that return is
-        --     unscaled and allowed to be negative. Exactly zero means "steady", and says nothing.
-        function PetFrame_SetHappiness()
-            local happiness, damagePercentage, loyaltyRate = GetPetHappiness()
-            local _, isHunterPet = HasPetUI()
-            if not (happiness and isHunterPet) then
-                PetFrameHappiness:Hide()
-                return
-            end
-            PetFrameHappiness:Show()
-
-            local cell = PET_HAPPINESS_CELL[happiness]
-            if cell then
-                PetFrameHappinessTexture:SetTexCoord(cell[1], cell[2], cell[3], cell[4])
-            end
-
-            PetFrameHappiness.tooltip = getglobal("PET_HAPPINESS" .. happiness)
-            PetFrameHappiness.tooltipDamage = format(PET_DAMAGE_PERCENTAGE, damagePercentage)
-            if loyaltyRate < 0 then
-                PetFrameHappiness.tooltipLoyalty = getglobal("LOSING_LOYALTY")
-            elseif loyaltyRate > 0 then
-                PetFrameHappiness.tooltipLoyalty = getglobal("GAINING_LOYALTY")
-            else
-                PetFrameHappiness.tooltipLoyalty = nil
-            end
-        end
-
-        -- The happiness face's hover. Both extra lines are drawn the same way — plain white,
-        -- nothing in the right-hand column — and either can be absent, so the stanza is written
-        -- once. The whole tooltip waits on the headline: until SetHappiness has run there is
-        -- nothing to say, and an empty plate is worse than none.
-        local function AddHappinessTooltipLine(text)
-            if text then
-                GameTooltip:AddLine(text, "", 1, 1, 1)
-            end
-        end
-
-        function BenillaPetHappiness_OnEnter(frame)
-            if not frame.tooltip then
-                return
-            end
-            GameTooltip:SetOwner(frame, "ANCHOR_RIGHT")
-            GameTooltip:SetText(frame.tooltip)
-            AddHappinessTooltipLine(frame.tooltipDamage)
-            AddHappinessTooltipLine(frame.tooltipLoyalty)
-            GameTooltip:Show()
-        end
-
-        -- The four debuff buttons (ref PetFrame.xml's $parentDebuff1..4 over RefreshBuffs). The pet
-        -- carries no aura timers — no unit but yourself does on the 1.12 wire (decision 0257 B6) —
-        -- so these are icon + border + stack count, the party rows' shape exactly.
-        function BenillaPetFrame_UpdateDebuffs()
-            for i = 1, 4 do
-                local button = getglobal("PetFrameDebuff" .. i)
-                local _, icon, count = UnitDebuff("pet", i)
-                if icon then
-                    getglobal(button:GetName() .. "Icon"):SetTexture(icon)
-                    local text = getglobal(button:GetName() .. "Count")
-                    if count and count > 1 then
-                        text:SetText(count)
-                        text:Show()
-                    else
-                        text:Hide()
-                    end
-                    button:Show()
-                else
-                    button:Hide()
-                end
-            end
-        end
-
-        -- ref PetFrame_OnUpdate: the attack overlay's alpha ramp — a 0.5 s-per-leg triangle between
-        -- 55/255 and 1, sign-flipped at each end (the ref's own counter shape, transcribed).
-        function PetFrame_OnUpdate(elapsed)
-            local frame = this
-            if not PetAttackModeTexture:IsVisible() then return end
-            local counter = frame.attackModeCounter + elapsed
-            local sign = frame.attackModeSign
-            if counter > 0.5 then
-                sign = -sign
-                frame.attackModeSign = sign
-            end
-            counter = mod(counter, 0.5)
-            frame.attackModeCounter = counter
-            local alpha
-            if sign == 1 then
-                alpha = (55 + (counter * 400)) / 255
-            else
-                alpha = (255 - (counter * 400)) / 255
-            end
-            PetAttackModeTexture:SetVertexColor(1.0, 1.0, 1.0, alpha)
-        end
-
-        -- Clicking the pet frame (decision 1066 built the right-hand half). The LEFT button hands
-        -- the pet whatever the cursor is carrying; every other button opens its menu — except for
-        -- the one case that is easy to drop, a RIGHT click with a spell already armed, which puts
-        -- the spell away instead. That exception is the right button's alone: a middle click while
-        -- casting still opens the menu.
-        function PetFrame_OnClick(button)
-            if button ~= "LeftButton" then
-                if button == "RightButton" and SpellIsTargeting() then
-                    SpellStopTargeting()
-                else
-                    -- No anchor arguments, unlike the player and target frames: this menu opens at
-                    -- the CURSOR (ref PetFrame.lua l.128).
-                    ToggleDropDownMenu(1, nil, PetFrameDropDown)
-                end
-                return
-            end
-            -- Most specific first: an armed spell binds to the pet, then a held item drops on it
-            -- (this is how you feed one), and with an empty cursor the click simply selects it.
-            if SpellIsTargeting() then
-                SpellTargetUnit("pet")
-            elseif CursorHasItem() then
-                DropItemOnUnit("pet")
-            else
-                TargetUnit("pet")
-            end
-        end
-
-        -- The PET menu's owner (ref PetFrame.lua l.158-166). The UnitExists gate is the ref's own,
-        -- and it is not redundant with the frame being hidden: this dropdown is also what the
-        -- TARGET frame's menu falls through to when you have your own pet selected.
-        function PetFrameDropDown_OnLoad()
-            UIDropDownMenu_Initialize(this, PetFrameDropDown_Initialize, "MENU")
-        end
-
-        function PetFrameDropDown_Initialize()
-            if UnitExists("pet") then
-                UnitPopup_ShowMenu(PetFrameDropDown, "PET", "pet")
-            end
-        end
-
-        function BenillaPetFrame_OnEnter(frame)
-            -- The pet frame is a unit frame in the reference, and takes the same cursor split:
-            -- hovering it with a spell armed lights or greys exactly as the target frame does.
-            if SpellIsTargeting() then
-                if SpellCanTargetUnit("pet") then
-                    SetCursor("CAST_CURSOR")
-                else
-                    SetCursor("CAST_ERROR_CURSOR")
-                end
-            end
-            if not UnitExists("pet") then return end
-            GameTooltip_SetDefaultAnchor(GameTooltip, frame)
-            if GameTooltip:SetUnit("pet") then
-                getglobal("GameTooltipTextLeft1"):SetTextColor(GameTooltip_UnitColor("pet"))
-            end
-        end
-    ]]></Script>
-
-    <!-- The debuff button — ref PartyBuffButtonTemplate (PartyFrameTemplates.xml l.3-35), which is
-         what the ref's PetFrame inherits for its four: a 15×15 icon under a 17×17
-         UI-Debuff-Overlays border. Untinted: the ref's party/pet buttons never recolor it (only the
-         target frame's dispel-tint law does), so this stays the flat swatch the TexCoords select. -->
-    <Button name="BenillaPetDebuffTemplate" virtual="true" hidden="true">
-        <Size><AbsDimension x="15" y="15"/></Size>
-        <Layers>
-            <Layer level="ARTWORK">
-                <Texture name="$parentIcon" setAllPoints="true"/>
-            </Layer>
-            <Layer level="OVERLAY">
-                <Texture name="$parentBorder" file="Interface\Buttons\UI-Debuff-Overlays">
-                    <Size><AbsDimension x="17" y="17"/></Size>
-                    <Anchors><Anchor point="CENTER"><Offset><AbsDimension x="0" y="0"/></Offset></Anchor></Anchors>
-                    <TexCoords left="0.296875" right="0.5703125" top="0" bottom="0.515625"/>
-                </Texture>
-                <FontString name="$parentCount" inherits="NumberFontNormalSmall">
-                    <Anchors><Anchor point="BOTTOMRIGHT"><Offset><AbsDimension x="-1" y="0"/></Offset></Anchor></Anchors>
-                </FontString>
-            </Layer>
-        </Layers>
-        <Scripts>
-            <OnEnter><![CDATA[
-                if GameTooltip then
-                    GameTooltip:SetOwner(this, "ANCHOR_RIGHT")
-                    GameTooltip:SetUnitDebuff("pet", this:GetID())
-                end
-            ]]></OnEnter>
-            <OnLeave>GameTooltip:Hide()</OnLeave>
-        </Scripts>
-    </Button>
-
-    <!-- frameStrata LOW matches the party frames' and the target's — above the player frame's
-         BACKGROUND (which it overlaps), still below the MEDIUM panels. -->
-    <Frame name="PetFrame" toplevel="true" parent="PlayerFrame" hidden="true" frameStrata="LOW">
-        <Size><AbsDimension x="128" y="53"/></Size>
-        <Anchors>
-            <Anchor point="TOPLEFT"><Offset><AbsDimension x="80" y="-60"/></Offset></Anchor>
-        </Anchors>
-        <Frames>
-            <!-- The PET-menu dropdown host (ref $parentDropDown, PetFrame.xml l.35-51): a hidden
-                 state-holder, like the player and target frames'. It carries the ref's own id=1
-                 and its 10×10 size; nothing anchors to it, because this menu opens at the cursor.
-                 It lives INSIDE the pet frame, which means it is only ever initialized once the
-                 pet frame exists — the same nesting the reference uses. -->
-            <Frame name="PetFrameDropDown" inherits="UIDropDownMenuTemplate" id="1" hidden="true">
-                <Size><AbsDimension x="10" y="10"/></Size>
-                <Anchors><Anchor point="TOP"><Offset><AbsDimension x="-20" y="-20"/></Offset></Anchor></Anchors>
-                <Scripts>
-                    <OnLoad>PetFrameDropDown_OnLoad()</OnLoad>
-                </Scripts>
-            </Frame>
-            <!-- Bars first, pushed one frame level under the TextureFrame at load (see OnLoad). -->
-            <StatusBar name="$parentHealthBar" enableMouse="true">
-                <Size><AbsDimension x="70" y="8"/></Size>
-                <Anchors><Anchor point="TOPLEFT"><Offset><AbsDimension x="47" y="-22"/></Offset></Anchor></Anchors>
-                <BarTexture file="Interface\TargetingFrame\UI-StatusBar"/>
-                <BarColor r="0" g="1.0" b="0"/>
-                <Scripts>
-                    <!-- The reference initialises a numerals bar from the BAR'S OWN OnLoad
-                         (PlayerFrame.xml l.300-303, PetFrame.xml l.138/163), never from the parent
-                         with the bar as an argument — `TextStatusBar_Initialize()` takes no
-                         argument in 1.12 and acts on `this`. Ours called it from the parent's
-                         OnLoad, which needed a widened signature and would have broken silently
-                         the day TextStatusBar.xml came off the player's chain (decisions 1793). -->
-                    <OnLoad>if TextStatusBar_Initialize then TextStatusBar_Initialize() end</OnLoad>
-                    <OnEvent>if TextStatusBar_OnEvent then TextStatusBar_OnEvent(arg1, arg2) end</OnEvent>
-                    <OnValueChanged>if TextStatusBar_OnValueChanged then TextStatusBar_OnValueChanged() end</OnValueChanged>
-                    <OnEnter>BenillaUnitFrameBar_OnEnter(self)</OnEnter>
-                    <OnLeave>BenillaUnitFrameBar_OnLeave(self)</OnLeave>
-                    <OnMouseUp>BenillaUnitFrameBar_OnMouseUp(self, arg1)</OnMouseUp>
-                </Scripts>
-            </StatusBar>
-            <StatusBar name="$parentManaBar" enableMouse="true">
-                <Size><AbsDimension x="70" y="8"/></Size>
-                <Anchors><Anchor point="TOPLEFT"><Offset><AbsDimension x="47" y="-29"/></Offset></Anchor></Anchors>
-                <BarTexture file="Interface\TargetingFrame\UI-StatusBar"/>
-                <BarColor r="0" g="0" b="1.0"/>
-                <Scripts>
-                    <!-- The reference initialises a numerals bar from the BAR'S OWN OnLoad
-                         (PlayerFrame.xml l.300-303, PetFrame.xml l.138/163), never from the parent
-                         with the bar as an argument — `TextStatusBar_Initialize()` takes no
-                         argument in 1.12 and acts on `this`. Ours called it from the parent's
-                         OnLoad, which needed a widened signature and would have broken silently
-                         the day TextStatusBar.xml came off the player's chain (decisions 1793). -->
-                    <OnLoad>if TextStatusBar_Initialize then TextStatusBar_Initialize() end</OnLoad>
-                    <OnEvent>if TextStatusBar_OnEvent then TextStatusBar_OnEvent(arg1, arg2) end</OnEvent>
-                    <OnValueChanged>if TextStatusBar_OnValueChanged then TextStatusBar_OnValueChanged() end</OnValueChanged>
-                    <OnEnter>BenillaUnitFrameBar_OnEnter(self)</OnEnter>
-                    <OnLeave>BenillaUnitFrameBar_OnLeave(self)</OnLeave>
-                    <OnMouseUp>BenillaUnitFrameBar_OnMouseUp(self, arg1)</OnMouseUp>
-                </Scripts>
-            </StatusBar>
-            <Frame name="$parentTextureFrame">
-                <Size><AbsDimension x="128" y="53"/></Size>
-                <Anchors><Anchor point="TOPLEFT"/></Anchors>
-                <Layers>
-                    <Layer level="BACKGROUND">
-                        <!-- Portrait 37×37 TOPLEFT (7,-6), under the art's round window (ref
-                             PetPortrait, PetFrame.xml l.16-27). -->
-                        <Texture name="PetPortrait">
-                            <Size><AbsDimension x="37" y="37"/></Size>
-                            <Anchors><Anchor point="TOPLEFT"><Offset><AbsDimension x="7" y="-6"/></Offset></Anchor></Anchors>
-                        </Texture>
-                    </Layer>
-                    <Layer level="BORDER">
-                        <!-- 128×64 art at (0,-2) — it hangs 13 px below the frame rect, as
-                             authored. The file is swapped at update (see the header). -->
-                        <Texture name="PetFrameTexture" file="Interface\TargetingFrame\UI-SmallTargetingFrame">
-                            <Size><AbsDimension x="128" y="64"/></Size>
-                            <Anchors><Anchor point="TOPLEFT"><Offset><AbsDimension x="0" y="-2"/></Offset></Anchor></Anchors>
-                        </Texture>
-                    </Layer>
-                    <Layer level="ARTWORK">
-                        <!-- The attacking overlay (ref PetAttackModeTexture, l.104-118): the right
-                             29.7% of UI-Player-AttackStatus, ADD-blended, pulsed by OnUpdate. -->
-                        <Texture name="PetAttackModeTexture" file="Interface\TargetingFrame\UI-Player-AttackStatus" alphaMode="ADD" hidden="true">
-                            <Size><AbsDimension x="76" y="64"/></Size>
-                            <Anchors><Anchor point="TOPLEFT"><Offset><AbsDimension x="6" y="-9"/></Offset></Anchor></Anchors>
-                            <TexCoords left="0.703125" right="1.0" top="0" bottom="1.0"/>
-                        </Texture>
-                    </Layer>
-                    <Layer level="OVERLAY">
-                        <FontString name="PetName" inherits="GameFontNormalSmall" justifyH="LEFT">
-                            <Anchors><Anchor point="BOTTOMLEFT"><Offset><AbsDimension x="50" y="33"/></Offset></Anchor></Anchors>
-                        </FontString>
-                        <!-- The pet's numerals: the reference's LITERAL seats, CENTER-from-TOPLEFT
-                             (82,-27) and (82,-38) (PetFrame.xml l.87-104). 1143 anchored these to
-                             the bars' own centres instead, on a comparison that was simply wrong —
-                             it read the ref's TEXT offsets against OUR BAR offsets and called the
-                             pitch different. The bars are byte-identical to the reference's, 70x8
-                             at (47,-22) and (47,-29), so the ref's text literals apply unchanged.
-                             The overlap that produced (director report, 2026-08-08, decision 1147)
-                             is what the literals exist to avoid: a 7 px bar pitch has no room for
-                             two centred ~12 px strings, so the reference drops the SECOND one clear
-                             of its bar (the mana bar ends at -37; its numerals sit at -38, just
-                             under it) rather than centring it. Centring both is what collided.
-                             No 1145 nudge here: that pixel was for a string centred in a bar, and
-                             the reference has already placed these deliberately off-centre. -->
-                        <FontString name="PetFrameHealthBarText" inherits="TextStatusBarText">
-                            <Anchors><Anchor point="CENTER" relativePoint="TOPLEFT"><Offset><AbsDimension x="82" y="-27"/></Offset></Anchor></Anchors>
-                        </FontString>
-                        <FontString name="PetFrameManaBarText" inherits="TextStatusBarText">
-                            <Anchors><Anchor point="CENTER" relativePoint="TOPLEFT"><Offset><AbsDimension x="82" y="-38"/></Offset></Anchor></Anchors>
-                        </FontString>
-                    </Layer>
-                </Layers>
-            </Frame>
-            <!-- HAPPINESS (ref PetFrameHappiness, PetFrame.xml l.233-253; decision 1005). 24×23
-                 anchored LEFT to the frame's RIGHT at (-7,-4), so it sits just inside the plate's
-                 right edge. The file is a three-icon strip and the AUTHORED TexCoords are
-                 happiness 3's — the ref ships the happy face and re-cuts it at update. -->
-            <Frame name="$parentHappiness" enableMouse="true">
-                <Size><AbsDimension x="24" y="23"/></Size>
-                <Anchors><Anchor point="LEFT" relativePoint="RIGHT"><Offset><AbsDimension x="-7" y="-4"/></Offset></Anchor></Anchors>
-                <Layers>
-                    <Layer level="BACKGROUND">
-                        <Texture name="$parentTexture" file="Interface\PetPaperDollFrame\UI-PetHappiness" setAllPoints="true">
-                            <Size><AbsDimension x="24" y="23"/></Size>
-                            <TexCoords left="0" right="0.1875" top="0" bottom="0.359375"/>
-                        </Texture>
-                    </Layer>
-                </Layers>
-                <Scripts>
-                    <OnEnter>
-                        BenillaPetHappiness_OnEnter(this)
-                    </OnEnter>
-                    <OnLeave>
-                        GameTooltip:Hide()
-                    </OnLeave>
-                </Scripts>
-            </Frame>
-            <!-- The four debuffs, ref geometry: the first at (48,-42), then +2 px chained right. -->
-            <Button name="$parentDebuff1" inherits="BenillaPetDebuffTemplate" id="1">
-                <Anchors><Anchor point="TOPLEFT"><Offset><AbsDimension x="48" y="-42"/></Offset></Anchor></Anchors>
-            </Button>
-            <Button name="$parentDebuff2" inherits="BenillaPetDebuffTemplate" id="2">
-                <Anchors><Anchor point="LEFT" relativeTo="PetFrameDebuff1" relativePoint="RIGHT"><Offset><AbsDimension x="2" y="0"/></Offset></Anchor></Anchors>
-            </Button>
-            <Button name="$parentDebuff3" inherits="BenillaPetDebuffTemplate" id="3">
-                <Anchors><Anchor point="LEFT" relativeTo="PetFrameDebuff2" relativePoint="RIGHT"><Offset><AbsDimension x="2" y="0"/></Offset></Anchor></Anchors>
-            </Button>
-            <Button name="$parentDebuff4" inherits="BenillaPetDebuffTemplate" id="4">
-                <Anchors><Anchor point="LEFT" relativeTo="PetFrameDebuff3" relativePoint="RIGHT"><Offset><AbsDimension x="2" y="0"/></Offset></Anchor></Anchors>
-            </Button>
-        </Frames>
-        <Scripts>
-            <OnLoad>PetFrame_OnLoad()</OnLoad>
-            <OnEvent>PetFrame_OnEvent(event)</OnEvent>
-            <OnUpdate>PetFrame_OnUpdate(arg1)</OnUpdate>
-            <OnEnter>BenillaPetFrame_OnEnter(this)</OnEnter>
-            <OnLeave>if SpellIsTargeting() then SetCursor("CAST_ERROR_CURSOR") end GameTooltip:FadeOut()</OnLeave>
-            <OnClick>PetFrame_OnClick(arg1)</OnClick>
-        </Scripts>
-    </Frame>
-</Ui>
diff --git a/crates/benilla-app/assets/ui/benilla.toc b/crates/benilla-app/assets/ui/benilla.toc
index ec8df4ee..fb27419c 100644
--- a/crates/benilla-app/assets/ui/benilla.toc
+++ b/crates/benilla-app/assets/ui/benilla.toc
@@ -216,75 +216,65 @@ Interface\FrameXML\ItemRef.xml
 # and the numerals simply never appear. The `.lua` comes first, as it does there.
 Interface\FrameXML\TextStatusBar.lua
 Interface\FrameXML\TextStatusBar.xml
+# ══ THE PLAYER AURA BAR — the reference's own, off the player's chain (1751) ══
+# The HUD row of buff/debuff icons under the minimap, driven by the UnitAura feed
+# (`crate::ui_aura`; decisions 0255/0257).
+#
+# FIRST OF THE KIT, which is the reference's own order (its toc: BuffFrame 40, CombatFeedback 41,
+# UnitFrame 43, PlayerFrame 44, PartyFrame 45, TargetFrame 46, PetFrame 47). It has to precede
+# PartyFrame because stock `PartyMemberFrame.lua:60` calls `RefreshBuffs` from each row's OnLoad
+# and `BuffFrame.lua` is where that lives. Ours had BuffFrame below the unit frames; that
+# inversion is gone.
+Interface\FrameXML\BuffFrame.xml
 # ══ THE UNIT-FRAME KIT — the reference's own, off the player's chain (1751, window 22) ══
 # `UnitFrame.xml` declares NO frames — it is a `<Script file="UnitFrame.lua"/>` and nothing else —
-# so this is a pure addition of thirteen globals: `UnitFrame_Initialize`, `_Update`, `_OnEvent`,
+# so it is a pure addition of thirteen globals: `UnitFrame_Initialize`, `_Update`, `_OnEvent`,
 # `_OnEnter`, `_OnLeave`, `_OnUpdate`, `_UpdateManaType`, the `UnitFrameHealthBar_*` /
-# `UnitFrameManaBar_*` pairs, and `GetUnitName`.
-#
-# ABOVE OURS ON PURPOSE, the `PaperDollFrame.lua` shape (see the top of this file): four of the
-# thirteen — `UnitFrame_Update`/`_OnEvent`/`_OnEnter`/`_OnLeave` — collide with bodies our own
-# UnitFrames.xml owns and drives, and the later line wins, so ours stay live. The other nine arrive
-# fresh, and `UnitFrame_Initialize` is the one that matters most: it is what stock
+# `UnitFrameManaBar_*` pairs, and `GetUnitName`. `UnitFrame_Initialize` is what stock
 # `PlayerFrame.xml`, `TargetFrame.xml`, `PartyFrame.xml` and `PetFrame.xml` each call in their
-# OnLoad, and its absence is the single blocker the readiness probe reports for all four.
+# OnLoad.
 #
-# So this is groundwork rather than a window: those four are the most visible thing on the screen
-# and their swap is a look the director has to see. This is the part that can land without one.
+# Until the four windows below arrived, our own UnitFrames.xml loaded underneath this and
+# redefined four of the thirteen — `_Update`, `_OnEvent`, `_OnEnter`, `_OnLeave` — so the
+# reference's bodies were dead the whole time and stock party rows would have called OUR update,
+# which indexed a `nameText` the reference's rows do not carry. That file is gone; these are live.
 Interface\FrameXML\UnitFrame.xml
-# …and its sibling, the same shape and the same reason. `CombatFeedback.xml` declares no frames
-# either: three timing constants plus `CombatFeedback_Initialize` / `_OnCombatEvent` / `_OnUpdate`,
-# the floating hit/miss text a unit frame's portrait carries. Two of the three collide with bodies
-# our UnitFrames.xml owns, so ours win from below; `CombatFeedback_Initialize` is the one that is
-# new, and it is the second of the two blockers the probe reports for stock `PlayerFrame.xml` and
-# `PetFrame.xml` (`UnitFrame_Initialize` above being the first). With both here, all four of the
-# reference's unit windows load clean.
+# The same shape and the same reason. `CombatFeedback.xml` declares no frames either: three timing
+# constants plus `CombatFeedback_Initialize` / `_OnCombatEvent` / `_OnUpdate`, the floating
+# hit/miss text a unit frame's portrait carries. Two of the three used to collide with bodies our
+# UnitFrames.xml owned; with that file gone the reference's three are what run.
 Interface\FrameXML\CombatFeedback.xml
-UnitFrames.xml
+# ── The four unit windows themselves (1751, window 22) ─────────────────────────────────────────
+# `PlayerFrame` + `PlayerStatusGlow` + `PlayerPlayTime` + `PlayerPVPIconHitArea` +
+# `PlayerFrameGroupIndicator` + the dropdown, out of `PlayerFrame.lua`.
+Interface\FrameXML\PlayerFrame.xml
+# `PartyMemberFrame1..4`, `PartyMemberBuffTooltip` and `PartyMemberBackground`, out of
+# `PartyMemberFrame.lua` (decision 0434 phase 2). Its `<Script>` list names `TextStatusBar.lua`
+# a second time, which is the reference's own doing and harmless — the file is idempotent.
+#
+# What moved out of our copy before it went: the PARTY_INVITE dialog and its driver, to
+# UiPanels.xml (StaticPopup.lua l.526, UIParent.lua), and the three raid constants, which
+# RaidFrame.xml already declared — that is the reference's home for them (RaidFrame.lua l.2-4).
+Interface\FrameXML\PartyFrame.xml
+# `TargetFrame`, its texture frame and dropdown, the sixteen debuff and five buff buttons with
+# their three templates, and the whole `TargetofTarget*` family — out of `TargetFrame.lua`, which
+# is also where `MAX_COMBO_POINTS` (l.1) and `SetRaidTargetIconTexture` live. `TargetofTarget_Update`
+# is what OptionsFrame.xml's two ToT settings drive.
+Interface\FrameXML\TargetFrame.xml
+# `PetFrame`, its health/mana bars, `PetFrameHappiness` and the dropdown, out of `PetFrame.lua`.
+Interface\FrameXML\PetFrame.xml
 # ══ THE COMBO-POINT DOTS — the reference's own, off the player's chain (1751, window 10) ══
 # `ComboFrame`, `ComboPoint1..5`, `ComboPointTemplate` and the `ComboPointsFrame_OnEvent` /
 # `ComboPointShineFade*` chain with its five duration constants, out of `ComboFrame.lua`.
 #
 # THE POSITION IS THE REQUIREMENT: `relativeTo="TargetFrame"` is resolved at LOAD, so this sits
-# below UnitFrames.xml. Its fade chain needs UiPanels.xml's `UIFrameFade` family, far above, at
-# call time.
-#
-# Our copy's frames were `BenillaComboPointTemplate` and kin; the reference's are
-# `ComboPointTemplate` / `ComboPoint<N>Highlight` / `ComboPoint<N>Shine`, which is what an addon
-# skinning the dots reaches for. `MAX_COMBO_POINTS` moved to UnitFrames.xml with this window —
-# 1.12 declares it on `TargetFrame.lua:1`, and our copy's own note said so while explaining that
-# it had nowhere else to go.
+# below TargetFrame.xml. Its fade chain needs UiPanels.xml's `UIFrameFade` family, far above, at
+# call time. `MAX_COMBO_POINTS` comes from TargetFrame.lua now, which is where 1.12 declares it.
 Interface\FrameXML\ComboFrame.xml
 # The center-screen scrolling combat text (decision 0578) — the Blizzard_CombatText
 # transcription; consumes COMBAT_TEXT_UPDATE + the regen/health/power events, needs
 # only Fonts.xml (CombatTextFont) + UIParent before it.
 CombatText.xml
-# The player buff/debuff bar (decisions 0255/0257 — the player aura arc): the HUD row of aura
-# icons under the minimap, driven by the UnitAura feed (`crate::ui_aura`).
-#
-# MOVED UP HERE from below the world-state frame when PartyFrame went to the chain (1751). It
-# has to precede PartyFrame, because stock `PartyMemberFrame.lua:60` calls `RefreshBuffs` from
-# each row's OnLoad and `BuffFrame.lua` is where that lives — which is exactly the reference's
-# own order (its toc: BuffFrame 40, UnitFrame 43, PartyFrame 45; ours had them inverted).
-#
-# The note this entry used to carry — "needs ActionBar's `BENILLA_FALLBACK_ICON`" — was stale:
-# that was true of OUR BuffFrame.xml, and the chain file does not mention the name. The only
-# readers left are MerchantFrame, StanceBar and TradeSkillFrame, all at runtime.
-Interface\FrameXML\BuffFrame.xml
-# The party member frames (decision 0434 phase 2).
-#
-# NOT yet on the chain, and the blocker is ours, not a missing verb: **`UnitFrames.xml` below
-# redefines `UnitFrame_OnEvent` and `UnitFrame_Update`**, two names stock `UnitFrame.lua` (l.232
-# above) has already defined. Ours win, so stock party rows — built by stock
-# `PartyMemberFrame.lua` and initialized by the reference's own `UnitFrame_Initialize` — end up
-# calling OUR update, which indexes a `nameText` the reference's rows do not carry. The swap
-# loads and then raises on the first PARTY_MEMBERS_CHANGED. So PartyFrame waits on the
-# player/target/pet frames, not on anything of its own.
-#
-# What HAS moved out: the PARTY_INVITE dialog and its driver, to UiPanels.xml (StaticPopup.lua
-# l.526, UIParent.lua), and the three raid constants, which RaidFrame.xml already declared —
-# that is the reference's home for them (RaidFrame.lua l.2-4).
-PartyFrame.xml
 # The death arc's dialogs + event driver (decision 0308): registry entries on the shared
 # StaticPopup engine, so after UiPanels.xml.
 DeathFrame.xml
diff --git a/crates/benilla-app/src/addon_harness/mod.rs b/crates/benilla-app/src/addon_harness/mod.rs
index 35167828..8c0e4603 100644
--- a/crates/benilla-app/src/addon_harness/mod.rs
+++ b/crates/benilla-app/src/addon_harness/mod.rs
@@ -4497,13 +4497,14 @@ mod dependency_tests {
     /// asserted to EXIST before the silence is asserted, and the test gates on client data like
     /// every other reader of the chain.
     ///
-    /// What is deliberately NOT asserted here is `load_default_ui`'s own failure list. It is not
-    /// empty on a seated session today — `TargetFrame`'s OnLoad reaches
-    /// `BenillaTargetAuras_Update` (UnitFrames.xml:956), which indexes `TargetofTargetFrame`
-    /// ~1150 lines before that frame is declared (UnitFrames.xml:2103), so a seated TARGET raises
-    /// there at load. That is a real bug in that file and a separate one from anything this test
-    /// measures; pinning it here would make the probe's gate hostage to it. Recorded rather than
-    /// worked around.
+    /// What is deliberately NOT asserted here is `load_default_ui`'s own failure list, and the
+    /// reason is a policy rather than a symptom: it is a different measurement from this one, and
+    /// pinning it here would make the probe's gate hostage to whatever else the chain is mid-way
+    /// through. (The concrete case that prompted the note has since gone with its file: our
+    /// `UnitFrames.xml` had `TargetFrame`'s OnLoad reach a `BenillaTargetAuras_Update` that indexed
+    /// `TargetofTargetFrame` ~1150 lines before the frame was declared, so a seated TARGET raised
+    /// at load. `TargetFrame.xml` is the reference's own now, 1751, and neither the caller nor the
+    /// ordering survives.)
     #[test]
     fn the_ui_probe_is_silent_on_a_clean_vm() {
         let _data = benilla_formats::wow_data_or_skip!();
diff --git a/crates/benilla-app/src/char_select/mod.rs b/crates/benilla-app/src/char_select/mod.rs
index c31d6082..e2dd91e4 100644
--- a/crates/benilla-app/src/char_select/mod.rs
+++ b/crates/benilla-app/src/char_select/mod.rs
@@ -1066,7 +1066,9 @@ mod tests {
         app.world_mut().resource_mut::<Roster>().pending_pick = Some(7);
 
         // One frame carrying both halves of the race, in the order the drain produces them.
-        app.world_mut().write_message(EnteredWorldMessage);
+        app.world_mut().write_message(EnteredWorldMessage {
+            billing_time_rested: 0,
+        });
         app.world_mut()
             .write_message(crate::net::DisconnectedMessage {
                 reason: "disconnected: world stream closed: failed to fill whole buffer".into(),
@@ -1105,7 +1107,9 @@ mod tests {
             .add_message::<crate::net::DisconnectedMessage>()
             .add_systems(Update, (enter_on_connected, back_on_disconnect).chain());
 
-        app.world_mut().write_message(EnteredWorldMessage);
+        app.world_mut().write_message(EnteredWorldMessage {
+            billing_time_rested: 0,
+        });
         app.world_mut()
             .write_message(crate::net::DisconnectedMessage {
                 reason: "logged out".into(),
diff --git a/crates/benilla-app/src/net.rs b/crates/benilla-app/src/net.rs
index c9c9f34e..5330c9ff 100644
--- a/crates/benilla-app/src/net.rs
+++ b/crates/benilla-app/src/net.rs
@@ -2173,7 +2173,12 @@ pub(crate) struct CharActionResultMessage {
 /// We entered the world (the IO thread's `Connected`, bridged from the Net drain): flips
 /// [`crate::char_select::ClientState`] to `InWorld`.
 #[derive(Message)]
-pub(crate) struct EnteredWorldMessage;
+pub(crate) struct EnteredWorldMessage {
+    /// The account's accumulated **rested billing minutes**, from the `SMSG_AUTH_RESPONSE` that
+    /// admitted the session — pushed into the script here because this is the only moment it ever
+    /// arrives (decision 1820).
+    pub(crate) billing_time_rested: u32,
+}
 
 /// The server asked us to play a cinematic (`SMSG_TRIGGER_CINEMATIC`) — a `CinematicSequences.dbc`
 /// id. Read by [`crate::cinematic`], which owns the playback *and* the ack (decision 0196: the ack
diff --git a/crates/benilla-app/src/net/apply.rs b/crates/benilla-app/src/net/apply.rs
index c8fcfd41..242f12a8 100644
--- a/crates/benilla-app/src/net/apply.rs
+++ b/crates/benilla-app/src/net/apply.rs
@@ -540,9 +540,11 @@ pub(super) fn apply_net_updates(
             SessionEvent::Connected {
                 self_guid: guid,
                 name,
+                billing_time_rested,
             } => session::connected(
                 guid,
                 name,
+                billing_time_rested,
                 &mut self_guid,
                 &mut status,
                 &mut names,
diff --git a/crates/benilla-app/src/net/apply/session.rs b/crates/benilla-app/src/net/apply/session.rs
index 375980ae..4179694f 100644
--- a/crates/benilla-app/src/net/apply/session.rs
+++ b/crates/benilla-app/src/net/apply/session.rs
@@ -104,6 +104,7 @@ pub(super) fn cinematic_triggered(
 pub(super) fn connected(
     guid: u64,
     name: String,
+    billing_time_rested: u32,
     self_guid: &mut SelfGuid,
     status: &mut NetStatus,
     names: &mut NameCache,
@@ -115,7 +116,9 @@ pub(super) fn connected(
     info!("net: in world as {name} (guid {guid})");
     // Our own name came with the login — seed the cache so "player" never queries.
     names.insert_player(guid, name, None);
-    entered_world.write(EnteredWorldMessage);
+    entered_world.write(EnteredWorldMessage {
+        billing_time_rested,
+    });
 }
 
 /// The server confirmed our logout (`SMSG_LOGOUT_COMPLETE`) — back to character select.
diff --git a/crates/benilla-app/src/net/io.rs b/crates/benilla-app/src/net/io.rs
index 2eef52aa..9fc8d188 100644
--- a/crates/benilla-app/src/net/io.rs
+++ b/crates/benilla-app/src/net/io.rs
@@ -588,11 +588,13 @@ fn run(
     session.player_login(guid)?;
     session.set_active_mover(guid)?;
 
+    let billing_time_rested = session.billing_time_rested();
     let (mut reader, writer) = session.into_split()?;
     if events_tx
         .send(SessionEvent::Connected {
             self_guid: guid,
             name,
+            billing_time_rested,
         })
         .is_err()
     {
diff --git a/crates/benilla-app/src/ui_script/character_tests.rs b/crates/benilla-app/src/ui_script/character_tests.rs
index 1eaac0d6..c6fbc564 100644
--- a/crates/benilla-app/src/ui_script/character_tests.rs
+++ b/crates/benilla-app/src/ui_script/character_tests.rs
@@ -40,6 +40,7 @@ fn player_unit() -> UnitState {
         class_file: Some("WARRIOR".into()),
         sex: 2,
         is_player: true,
+        player_controlled: true,
         ..Default::default()
     }
 }
diff --git a/crates/benilla-app/src/ui_script/combo_frame_tests.rs b/crates/benilla-app/src/ui_script/combo_frame_tests.rs
index 6ecfc7ae..f32ef986 100644
--- a/crates/benilla-app/src/ui_script/combo_frame_tests.rs
+++ b/crates/benilla-app/src/ui_script/combo_frame_tests.rs
@@ -12,8 +12,9 @@ const MOB_B: u64 = 0xF130_0000_0000_0002;
 
 use super::test_ui::load_ui as load_xml;
 
-/// The manifest order this file actually ships in: `UiPanels.xml` for `UIFrameFade`,
-/// `UnitFrames.xml` for the `TargetFrame` the dots anchor to.
+/// The manifest order this file actually ships in: `UiPanels.xml` for `UIFrameFade`, and the
+/// reference's own `TargetFrame.xml` for the `TargetFrame` the dots anchor to — `relativeTo` is
+/// resolved at LOAD, so that file has to precede this one (1751).
 fn load_combo_frame() -> UiScript {
     let mut s = UiScript::new().unwrap();
     s.set_screen_size(1024.0, 768.0);
@@ -24,7 +25,15 @@ fn load_combo_frame() -> UiScript {
     load_xml(&s, "UnitPopup.xml");
     load_xml(&s, "MoneyFrame.xml");
     load_xml(&s, "UiPanels.xml");
-    load_xml(&s, "UnitFrames.xml");
+    load_xml(&s, "Interface\\FrameXML\\TextStatusBar.lua");
+    load_xml(&s, "Interface\\FrameXML\\TextStatusBar.xml");
+    load_xml(&s, "Interface\\FrameXML\\BuffFrame.xml");
+    load_xml(&s, "Interface\\FrameXML\\UnitFrame.xml");
+    load_xml(&s, "Interface\\FrameXML\\CombatFeedback.xml");
+    load_xml(&s, "Interface\\FrameXML\\PlayerFrame.xml");
+    load_xml(&s, "Interface\\FrameXML\\PartyFrame.xml");
+    load_xml(&s, "Interface\\FrameXML\\TargetFrame.xml");
+    load_xml(&s, "Interface\\FrameXML\\PetFrame.xml");
     load_xml(&s, "Interface\\FrameXML\\ComboFrame.xml");
     s.resolve();
     assert!(s.errors().is_empty(), "script errors: {:?}", s.errors());
diff --git a/crates/benilla-app/src/ui_script/frame_flag_gate.rs b/crates/benilla-app/src/ui_script/frame_flag_gate.rs
index 8abe4b5a..5ab83ba4 100644
--- a/crates/benilla-app/src/ui_script/frame_flag_gate.rs
+++ b/crates/benilla-app/src/ui_script/frame_flag_gate.rs
@@ -271,20 +271,11 @@ const KNOWN: &[Known] = &[
               under a mouse-enabled parent; `OnClick` dismisses a held spell, 0843). Unwinding \
               that is the chat window's own piece of work, not this flag's.",
     },
-    Known {
-        frame: "TargetofTargetHealthBar",
-        flag: Flag::Mouse,
-        why: "a plain StatusBar where the reference inherits TextStatusBar, whose OnEnter/OnLeave \
-              show the value text. Wants the status-text arc, not the flag. (The pet page's XP bar \
-              was this entry's twin until its window became the reference's own.)",
-    },
-    Known {
-        frame: "TargetofTargetManaBar",
-        flag: Flag::Mouse,
-        why: "a plain StatusBar where the reference inherits TextStatusBar, whose OnEnter/OnLeave \
-              show the value text. Wants the status-text arc, not the flag. (The pet page's XP bar \
-              was this entry's twin until its window became the reference's own.)",
-    },
+    // The two `TargetofTarget*Bar` entries RETIRED here (the unit-frame migration), for the same
+    // reason their twin the pet page's XP bar went: they said our bars were plain StatusBars where
+    // the reference inherits `TextStatusBar` — true of our transcription, and no longer true of
+    // anything. `TargetFrame.xml` is the reference's own now and its ToT bars inherit
+    // `TextStatusBar` like every other unit bar. The gate found them itself, which is its job.
     Known {
         frame: "TradePlayerItem7",
         flag: Flag::Mouse,
diff --git a/crates/benilla-app/src/ui_script/game_menu_tests.rs b/crates/benilla-app/src/ui_script/game_menu_tests.rs
index 5a571f1a..9bb9a2a1 100644
--- a/crates/benilla-app/src/ui_script/game_menu_tests.rs
+++ b/crates/benilla-app/src/ui_script/game_menu_tests.rs
@@ -268,7 +268,11 @@ fn the_open_menu_takes_the_screen_and_refuses_every_other_panel() {
             // what it needs and why, and PartyFrame's `MAX_PARTY_MEMBERS` is needed at LOAD.
             "UIDropDownMenu.xml",
             "UnitPopup.xml",
-            "PartyFrame.xml",
+            "Interface\\FrameXML\\TextStatusBar.lua",
+            "Interface\\FrameXML\\TextStatusBar.xml",
+            "Interface\\FrameXML\\UnitFrame.xml",
+            "Interface\\FrameXML\\BuffFrame.xml",
+            "Interface\\FrameXML\\PartyFrame.xml",
             "Interface\\FrameXML\\ItemButtonTemplate.xml",
             "Interface\\FrameXML\\LootFrame.xml",
         ],
@@ -598,7 +602,11 @@ fn nothing_opens_behind_the_world_map_and_escape_closes_it_first() {
         // The loot window is the reference's own since 1751 — see `test_ui::LOOT_UI` for what
         // each of these buys; `PartyFrame`'s MAX_PARTY_MEMBERS is needed at LOAD time.
         "UnitPopup.xml",
-        "PartyFrame.xml",
+        "Interface\\FrameXML\\TextStatusBar.lua",
+        "Interface\\FrameXML\\TextStatusBar.xml",
+        "Interface\\FrameXML\\UnitFrame.xml",
+        "Interface\\FrameXML\\BuffFrame.xml",
+        "Interface\\FrameXML\\PartyFrame.xml",
         "Interface\\FrameXML\\ItemButtonTemplate.xml",
         "Interface\\FrameXML\\LootFrame.xml",
     ]);
diff --git a/crates/benilla-app/src/ui_script/inspect_tests.rs b/crates/benilla-app/src/ui_script/inspect_tests.rs
index eeaf2ec8..43f324a4 100644
--- a/crates/benilla-app/src/ui_script/inspect_tests.rs
+++ b/crates/benilla-app/src/ui_script/inspect_tests.rs
@@ -51,6 +51,7 @@ fn target_unit() -> UnitState {
         class_file: Some("PALADIN".into()),
         sex: 2,
         is_player: true,
+        player_controlled: true,
         ..Default::default()
     }
 }
diff --git a/crates/benilla-app/src/ui_script/instance_tests.rs b/crates/benilla-app/src/ui_script/instance_tests.rs
index fc04bf96..561dd462 100644
--- a/crates/benilla-app/src/ui_script/instance_tests.rs
+++ b/crates/benilla-app/src/ui_script/instance_tests.rs
@@ -89,7 +89,15 @@ fn the_self_menu_row_gates_on_the_binding_and_confirms_before_sending() {
         "GameTooltip.xml",
         "UIDropDownMenu.xml",
         "UnitPopup.xml",
-        "UnitFrames.xml",
+        "Interface\\FrameXML\\TextStatusBar.lua",
+        "Interface\\FrameXML\\TextStatusBar.xml",
+        "Interface\\FrameXML\\BuffFrame.xml",
+        "Interface\\FrameXML\\UnitFrame.xml",
+        "Interface\\FrameXML\\CombatFeedback.xml",
+        "Interface\\FrameXML\\PlayerFrame.xml",
+        "Interface\\FrameXML\\PartyFrame.xml",
+        "Interface\\FrameXML\\TargetFrame.xml",
+        "Interface\\FrameXML\\PetFrame.xml",
         "RaidFrame.xml",
     ] {
         load_xml(&s, file);
diff --git a/crates/benilla-app/src/ui_script/lifecycle.rs b/crates/benilla-app/src/ui_script/lifecycle.rs
index 581fe862..d536ae58 100644
--- a/crates/benilla-app/src/ui_script/lifecycle.rs
+++ b/crates/benilla-app/src/ui_script/lifecycle.rs
@@ -381,6 +381,7 @@ pub(crate) fn seat_from_roster(
             _ => 0,
         },
         is_player: true,
+        player_controlled: true,
         // Nil here is not "no faction", it is a state a player character cannot be in, and
         // AceDB-2.0 concatenates it at file scope — see [`crate::ui_unit::race_faction_group`].
         faction_group: crate::ui_unit::race_faction_group(row.race).map(str::to_string),
diff --git a/crates/benilla-app/src/ui_script/manifest.rs b/crates/benilla-app/src/ui_script/manifest.rs
index ee1d19a4..fb69f7f6 100644
--- a/crates/benilla-app/src/ui_script/manifest.rs
+++ b/crates/benilla-app/src/ui_script/manifest.rs
@@ -154,8 +154,20 @@ end
 /// the addon harness ([`crate::addon_harness`]), which needs our entire interface under each
 /// surveyed addon.
 pub(crate) fn load_default_ui(script: &UiScript) -> Vec<String> {
+    // **Silent, the way the client's own load is.** `0x48fbf0` brackets ITSELF in the counted
+    // sound-suppression scope — `0x48fbfa call 0x458f50` on entry, `0x49016d call 0x458f60` on
+    // exit — across the TOC walk, Bindings.xml and the AddOns, so both of its callers (login
+    // `0x48f681` and `/reloadui` `0x495669`) load without a sound. The only reader of that depth
+    // is `PlaySoundByName 0x458030`, which drops the call outright.
+    //
+    // This is the mechanism, not a workaround for one noisy handler: stock `TargetFrame_OnHide`
+    // really does fire at load (the frame ships shown and its OnLoad hides it) and really does
+    // call `PlaySound("INTERFACESOUND_LOSTTARGETUNIT")`. The engine throws it away. Decision 1033
+    // reached the right rule from the director's ear; this is the binary agreeing.
+    script.push_sound_suppression();
     let mut failures = load_manifest(script, &Addon::builtin().toc.files);
     failures.extend(bootstrap_positions(script));
+    script.pop_sound_suppression();
     failures
 }
 
diff --git a/crates/benilla-app/src/ui_script/mod.rs b/crates/benilla-app/src/ui_script/mod.rs
index 5af9e319..ed875c54 100644
--- a/crates/benilla-app/src/ui_script/mod.rs
+++ b/crates/benilla-app/src/ui_script/mod.rs
@@ -9,8 +9,9 @@
 //! units tall every frame, and [`seam_scale`] carries quads ×s out / mouse ÷s in. The quad pass
 //! wants y-down window px, so extraction also flips through the window height.
 //!
-//! Benilla's own **unit frames** (`assets/ui/UnitFrames.xml` — a template + the player and target
-//! instances) load at startup by default through [`benilla_ui::loader`] — the decision 0068 slice-1
+//! The **unit frames** (the reference's own `Interface\FrameXML\{PlayerFrame,PartyFrame,
+//! TargetFrame,PetFrame}.xml`, off the player's chain since 1751 — our `UnitFrames.xml`
+//! transcription is retired) load at startup through [`benilla_ui::loader`] — the decision 0068 slice-1
 //! game-shell: real FrameXML+Lua rendering unit health/power/level/name through the whole chain
 //! (snapshot → `Unit*` bindings → Lua → event → StatusBars+text → quad pass). Since captures run
 //! server-less (no real game state), `WOW_CAPTURE_UI=1` also feeds synthetic `"player"`/`"target"`
@@ -550,6 +551,7 @@ fn demo_unit_feed(script: Option<NonSendMut<UiScript>>, mut fired: Local<VmMemo<
             class_file: Some("WARRIOR".into()),
             sex: 2,
             is_player: true,
+            player_controlled: true,
             ..Default::default()
         }),
     );
diff --git a/crates/benilla-app/src/ui_script/options_tests.rs b/crates/benilla-app/src/ui_script/options_tests.rs
index fba459e2..8ce6f217 100644
--- a/crates/benilla-app/src/ui_script/options_tests.rs
+++ b/crates/benilla-app/src/ui_script/options_tests.rs
@@ -730,11 +730,23 @@ fn interface_harness() -> UiScript {
             "UnitPopup.xml",
             "Interface\\FrameXML\\TextStatusBar.lua",
             "Interface\\FrameXML\\TextStatusBar.xml",
-            "UnitFrames.xml",
+            "Interface\\FrameXML\\BuffFrame.xml",
+            "Interface\\FrameXML\\UnitFrame.xml",
+            "Interface\\FrameXML\\CombatFeedback.xml",
+            "Interface\\FrameXML\\PlayerFrame.xml",
+            "Interface\\FrameXML\\PartyFrame.xml",
+            "Interface\\FrameXML\\TargetFrame.xml",
+            "Interface\\FrameXML\\PetFrame.xml",
+            // `PartyMemberBackground`'s OnEvent sets `OpacityFrameSlider` on VARIABLES_LOADED,
+            // and that slider is declared in ColorPickerFrame.xml. The reference loads them in
+            // this same order (its toc: PartyFrame 45, ColorPickerFrame 84) — it works there
+            // because the reader is an EVENT handler, not a load-time one, so by the time
+            // VARIABLES_LOADED fires the slider exists. A test that fires the event has to have
+            // loaded it too.
+            "Interface\\FrameXML\\ColorPickerFrame.xml",
             "Cooldown.xml",
             "ActionBar.xml",
             "ScrollTemplates.xml",
-            "Interface\\FrameXML\\BuffFrame.xml",
             "Interface\\FrameXML\\MerchantFrame.xml",
             "QuestFrame.xml",
             "QuestLogFrame.xml",
diff --git a/crates/benilla-app/src/ui_script/pet_frame_tests.rs b/crates/benilla-app/src/ui_script/pet_frame_tests.rs
index 3849e4ec..de8a9c90 100644
--- a/crates/benilla-app/src/ui_script/pet_frame_tests.rs
+++ b/crates/benilla-app/src/ui_script/pet_frame_tests.rs
@@ -31,7 +31,15 @@ fn load_pet_frame() -> UiScript {
     load_xml(&s, "GameTooltip.xml");
     load_xml(&s, "UIDropDownMenu.xml");
     load_xml(&s, "UnitPopup.xml");
-    load_xml(&s, "UnitFrames.xml");
+    load_xml(&s, "Interface\\FrameXML\\TextStatusBar.lua");
+    load_xml(&s, "Interface\\FrameXML\\TextStatusBar.xml");
+    load_xml(&s, "Interface\\FrameXML\\BuffFrame.xml");
+    load_xml(&s, "Interface\\FrameXML\\UnitFrame.xml");
+    load_xml(&s, "Interface\\FrameXML\\CombatFeedback.xml");
+    load_xml(&s, "Interface\\FrameXML\\PlayerFrame.xml");
+    load_xml(&s, "Interface\\FrameXML\\PartyFrame.xml");
+    load_xml(&s, "Interface\\FrameXML\\TargetFrame.xml");
+    load_xml(&s, "Interface\\FrameXML\\PetFrame.xml");
     s.set_unit(
         "player",
         Some(UnitState {
@@ -61,6 +69,12 @@ fn pet(name: &str, health: u32, power: u32, max_power: u32, power_type: u8) -> U
         power_type,
         power,
         max_power,
+        // Every token the app's feed pushes is connected (`ui_unit.rs`, "the stated
+        // `is_connected` gap, closed"). It matters to the reference's own bar: stock
+        // `UnitFrameManaBar_Update` (UnitFrame.lua:213) greys a DISCONNECTED unit's bar to
+        // (0.5,0.5,0.5) and only reaches `UnitFrame_UpdateManaType`'s power colour otherwise, so a
+        // fixture that leaves this false paints every bar grey and tests nothing about power type.
+        is_connected: true,
         ..UnitState::default()
     }
 }
@@ -92,7 +106,9 @@ fn draws(s: &mut UiScript, path: &str) -> bool {
     drawn(s).iter().any(|(p, _)| p == path)
 }
 
-fn debuff(spell_id: u32, name: &str, count: u8) -> AuraState {
+/// One aura on the pet's row. **Helpful**, because the row the pet frame fills is a BUFF row —
+/// see [`the_debuff_row_fills_from_the_pets_own_auras`] for the reference's own `showBuffs = 1`.
+fn pet_buff(spell_id: u32, name: &str, count: u8) -> AuraState {
     AuraState {
         spell_id,
         name: Some(name.into()),
@@ -102,7 +118,7 @@ fn debuff(spell_id: u32, name: &str, count: u8) -> AuraState {
         // No unit but yourself carries a duration on the 1.12 wire (decision 0257 B6).
         duration: 0.0,
         expiration_time: 0.0,
-        helpful: false,
+        helpful: true,
         cancelable: false,
         until_cancelled: false,
         channeled: false,
@@ -183,10 +199,28 @@ fn the_frame_answers_only_the_events_that_name_its_own_unit() {
     assert!(!s.eval::<bool>("return PetFrame:IsVisible()").unwrap());
 }
 
-/// The reference's art swap (`PetFrame.lua`'s Update): a pet with no power wears the `-NoMana`
+/// The reference's art swap (`PetFrame.lua:29-33`): a pet with no power wears the `-NoMana`
 /// plate, which has no mana rail to leave empty — and the bar hides with it. A hunter's FOCUS pet
 /// takes the plain plate and the focus colour, which is the case the mana-coloured default would
 /// get wrong.
+///
+/// **Two things about the reference's wiring that our transcription did not have.**
+///
+/// *The plate's only wire is `UNIT_PET`.* `PetFrame_Update` — the sole caller of the
+/// `UnitManaMax("pet") == 0` fork — runs from `PetFrame_OnEvent`'s `UNIT_PET`/`arg1 == "player"`
+/// arm and from the frame's `OnShow` (`PetFrame.lua:46-49`, `PetFrame.xml:284-287`), and from
+/// nothing else. This fixture used to poke `UNIT_MAXPOWER`, which the stock frame does not
+/// register at all — nor could it, since the bar's own registrations are 1.12's
+/// `UNIT_MANA`/`UNIT_MAXMANA`/… (`UnitFrame.lua:190-200`) rather than our Era pair. Swapping one
+/// pet for a differently-powered one is a `UNIT_PET` on the wire, which is the honest edge here.
+///
+/// *Nothing in `PetFrame.lua` hides the bar.* The hide comes out of `TextStatusBar`: the bar
+/// inherits that template's `<OnValueChanged>` (`TextStatusBar.xml:32-34` — `PetFrame.xml:161-169`
+/// overrides only OnLoad/OnEvent), so `UnitFrameManaBar_Update`'s `SetMinMaxValues(0, 0)`
+/// (`UnitFrame.lua:211-212`) reaches `TextStatusBar_UpdateTextString`, whose `valueMax > 0` else
+/// branch is `textStatusBar:Hide()` (`TextStatusBar.lua:34/55-57`). Same visible answer as our
+/// transcription's explicit `Hide()`, by a different and much longer road — which is worth knowing,
+/// because it means the bar comes back only through a value change, never through `PetFrame.lua`.
 #[test]
 fn a_powerless_pet_wears_the_no_mana_plate() {
     let mut s = load_pet_frame();
@@ -208,9 +242,10 @@ fn a_powerless_pet_wears_the_no_mana_plate() {
     assert!(draws(&mut s, PLAIN), "the plate with a mana rail");
     assert!(!draws(&mut s, NO_MANA));
 
-    // A skeleton: no power at all.
+    // A skeleton: no power at all. `UNIT_PET` names the OWNER — see the doc above for why it, and
+    // not a power event, is what re-cuts the plate.
     s.set_unit("pet", Some(pet("Skeleton", 100, 0, 0, 0)));
-    s.fire_event("UNIT_MAXPOWER", vec![ScriptValue::Str("pet".into())]);
+    s.fire_event("UNIT_PET", vec![ScriptValue::Str("player".into())]);
     assert!(
         !s.eval::<bool>("return PetFrameManaBar:IsVisible()")
             .unwrap(),
@@ -259,8 +294,25 @@ fn the_attack_overlay_follows_its_own_two_events() {
         .unwrap());
 }
 
-/// The four debuff buttons fill from `UnitDebuff("pet", i)` in order, show a stack count only above
-/// 1, and the unused ones hide. `UNIT_AURA("pet")` is the wire.
+/// The four `$parentDebuff` buttons fill from the pet's own auras in order and the unused ones
+/// hide. `UNIT_AURA("pet")` is the wire (`PetFrame.lua:54-57`).
+///
+/// **Two things the reference does that our deleted transcription did not**, both worth stating
+/// because the frames' NAMES argue for the opposite on both counts:
+///
+/// 1. **The row shows BUFFS, not debuffs**, despite every frame in it being called
+///    `PetFrameDebuffN`. `PetFrame.lua:37`/`:56` are the only two `RefreshBuffs` calls in the whole
+///    of 1.12's FrameXML that pass `showBuffs = 1`, and that argument selects
+///    `UnitBuff(unit, i, SHOW_CASTABLE_BUFFS)` at `BuffFrame.lua:277`. (Every other caller —
+///    `PartyMemberFrame.lua:60`/`:176`/`:259`, `TargetFrame.lua:538` — passes `0`, which is the
+///    `UnitDebuff` arm at `:280`.) Our `BenillaPetFrame_UpdateDebuffs` read `UnitDebuff("pet", i)`,
+///    so a hunter whose pet was buffed saw an empty row and a poisoned pet saw icons the reference
+///    would not show.
+/// 2. **There is no stack count.** `RefreshBuffs` sets an icon and a border and nothing else
+///    (`BuffFrame.lua:287-301`), and `PartyBuffButtonTemplate` — the template all four inherit
+///    (`PetFrame.xml:173`/`:188`/`:203`/`:218`) — declares only `$parentIcon` and `$parentBorder`
+///    (`PartyFrameTemplates.xml:3-36`). `PetFrameDebuff2Count` is not a frame in the reference's
+///    house at all; the old assertion was reading a FontString our transcription invented.
 #[test]
 fn the_debuff_row_fills_from_the_pets_own_auras() {
     let mut s = load_pet_frame();
@@ -269,7 +321,7 @@ fn the_debuff_row_fills_from_the_pets_own_auras() {
 
     s.set_auras(
         "pet",
-        Some(vec![debuff(1000, "Rend", 1), debuff(1001, "Sunder", 3)]),
+        Some(vec![pet_buff(1000, "Rend", 1), pet_buff(1001, "Sunder", 3)]),
     );
     s.fire_event("UNIT_AURA", vec![ScriptValue::Str("pet".into())]);
 
@@ -280,15 +332,23 @@ fn the_debuff_row_fills_from_the_pets_own_auras() {
                and PetFrameDebuff2:IsVisible()
                and not PetFrameDebuff3:IsVisible()
                and not PetFrameDebuff4:IsVisible()
-               and not PetFrameDebuff1Count:IsVisible()
-               and PetFrameDebuff2Count:IsVisible()
-               and PetFrameDebuff2Count:GetText() == "3"
+               -- The reference has no count region on this template at all — not a hidden one.
+               and getglobal("PetFrameDebuff1Count") == nil
+               and getglobal("PetFrameDebuff2Count") == nil
             "#,
         )
         .unwrap();
-    assert!(ok, "two debuffs draw, a stack count shows only above 1");
-    // …and the icons are the pet's own auras, in the pet's own order.
-    assert!(draws(&mut s, "Interface\\Icons\\Spell_1000"));
+    assert!(ok, "two auras draw, the other two rows stay down");
+    // …and the icons are the pet's own auras, in the pet's own order. `RefreshBuffs` paints them
+    // with `debuffIcon:SetTexture(debuff)` where `debuff` is `UnitBuff`'s FIRST return
+    // (`BuffFrame.lua:277`/`:288`) — which on the 1.12 wire is the texture path
+    // (`TargetFrame.lua:269-272` uses it the same way, and `:287-303` reads the debuff triple as
+    // `texture, applications, dispelType`).
+    assert!(
+        draws(&mut s, "Interface\\Icons\\Spell_1000"),
+        "the first buff's ICON draws — if this fails with the aura's NAME on the row instead, \
+         `UnitBuff`'s first return is the Era signature's `name`, not 1.12's texture"
+    );
     assert!(draws(&mut s, "Interface\\Icons\\Spell_1001"));
 
     // They clear when the auras do.
@@ -523,12 +583,24 @@ fn unit_happiness_repaints_only_the_icon() {
 /// The layering law (decision 0884), the pet frame's copy of the player/target/party tests: the
 /// frame art must draw OVER the bar fills, which only the frame LEVEL can hold — the draw layer is
 /// bucket-wide. A "simplification" back to declaration order puts the bars on top as pasted slabs.
+///
+/// **The art frame has no name in the reference, so it is reached through its texture.** Our
+/// deleted transcription gave it one (`PetFrameTextureFrame`); stock `PetFrame.xml:52-124` builds
+/// it as two ANONYMOUS `<Frame setAllPoints="true">` wrappers, one inside the other, with
+/// `PetFrameTexture` in the inner one's BACKGROUND layer. That nesting is how the reference buys
+/// the level: `PetFrame` is 2, its direct children (both bars, `PetFrame.xml:125`/`:150`) are 3,
+/// and the doubly-nested art frame is 4. The law is unchanged — the art is one level above the
+/// bars — only the way to name the frame is, so this asks the texture for its parent.
+///
+/// It is also *why* the reference needs no `PetFrameManaBar:Hide()` of its own for the
+/// [`a_powerless_pet_wears_the_no_mana_plate`] case: the `-NoMana` plate is painted a level ABOVE
+/// the mana bar and simply covers the rail.
 #[test]
 fn the_pet_art_paints_over_the_bars() {
     let s = load_pet_frame();
     let level: (i64, i64, i64) = s
         .eval(
-            "return PetFrameTextureFrame:GetFrameLevel(), \
+            "return PetFrameTexture:GetParent():GetFrameLevel(), \
                     PetFrameHealthBar:GetFrameLevel(), \
                     PetFrameManaBar:GetFrameLevel()",
         )
diff --git a/crates/benilla-app/src/ui_script/pet_paperdoll_tests.rs b/crates/benilla-app/src/ui_script/pet_paperdoll_tests.rs
index 13cab1cf..0dab35d2 100644
--- a/crates/benilla-app/src/ui_script/pet_paperdoll_tests.rs
+++ b/crates/benilla-app/src/ui_script/pet_paperdoll_tests.rs
@@ -47,6 +47,7 @@ fn player_unit() -> UnitState {
         class_file: Some("HUNTER".into()),
         sex: 2,
         is_player: true,
+        player_controlled: true,
         ..UnitState::default()
     }
 }
diff --git a/crates/benilla-app/src/ui_script/quiver_tests.rs b/crates/benilla-app/src/ui_script/quiver_tests.rs
index d46d1242..a2b76f04 100644
--- a/crates/benilla-app/src/ui_script/quiver_tests.rs
+++ b/crates/benilla-app/src/ui_script/quiver_tests.rs
@@ -142,6 +142,7 @@ fn seat_a_hunter(root: &Path) -> UiScript {
             class_file: Some("HUNTER".into()),
             sex: 2,
             is_player: true,
+            player_controlled: true,
             faction_group: Some("Alliance".into()),
             ..Default::default()
         }),
diff --git a/crates/benilla-app/src/ui_script/reference_ui.rs b/crates/benilla-app/src/ui_script/reference_ui.rs
index 3fd348dc..d5492a6c 100644
--- a/crates/benilla-app/src/ui_script/reference_ui.rs
+++ b/crates/benilla-app/src/ui_script/reference_ui.rs
@@ -1044,10 +1044,11 @@ mod tests {
     /// A window that reads unblocked in [`chain_gap_report`] can still fail to swap, and the third
     /// reason found (after a missing widget type and a missing widget method) is this one: our
     /// `assets/ui` file defines a global the reference defines too, our manifest loads a CHAIN file
-    /// that also defines it, and whichever lands second wins. `PartyFrame.xml` is the worked
-    /// example — `UnitFrames.xml` redefines `UnitFrame_OnEvent`/`UnitFrame_Update` nine manifest
-    /// lines after stock `UnitFrame.lua` defines them, so a stock party row built by the
-    /// reference's own `UnitFrame_Initialize` calls OUR update and indexes a field its rows do not
+    /// that also defines it, and whichever lands second wins. `PartyFrame.xml` was the worked
+    /// example, and it is worth keeping in the past tense because it is what this check was built
+    /// to catch: our `UnitFrames.xml` redefined `UnitFrame_OnEvent`/`UnitFrame_Update` nine
+    /// manifest lines after stock `UnitFrame.lua` defined them, so a stock party row built by the
+    /// reference's own `UnitFrame_Initialize` called OUR update and indexed a field its rows do not
     /// carry. It loads clean and raises on the first event.
     ///
     /// Shadowing is not automatically wrong — where we ship a file the reference would have
@@ -1062,10 +1063,11 @@ mod tests {
     /// both would declare the same frames.
     ///
     /// That half doubles as the map nothing else holds: `ActionBarFrame.xml` is our
-    /// `ActionBar.xml`, `FloatingChatFrame.xml` is our `ChatFrame.xml`, `PlayerFrame.xml` and
-    /// `TargetFrame.xml` and `PetFrame.xml` are all our one `UnitFrames.xml`,
+    /// `ActionBar.xml`, `FloatingChatFrame.xml` is our `ChatFrame.xml`,
     /// `MainMenuBarMicroButtons.xml` is our `MicroMenu.xml`, `StaticPopup.xml` is our
-    /// `UiPanels.xml`. `chain_gap_report` calls several of those unblocked, and they are —
+    /// `UiPanels.xml`. (The row this map used to lead with — `PlayerFrame.xml`/`TargetFrame.xml`/
+    /// `PetFrame.xml` all being our one `UnitFrames.xml` — is retired: those four are the
+    /// reference's own files now, 1751.) `chain_gap_report` calls several of those unblocked, and they are —
     /// individually. They just cannot load beside the file of ours already holding their names.
     ///
     /// Run it before attempting a swap. It predicts which ones will fail without attempting them.
@@ -1083,8 +1085,10 @@ mod tests {
         // and missed the case it was built for), because a reference can live in any file. A
         // declaration cannot.
         //
-        // What it catches: our `UnitFrames.xml` declares `PetFrame`, and so does the stock
-        // `PetFrame.xml`. Adding that stock file alongside ours would declare the name twice.
+        // What it catches, in the case it was built for: our `UnitFrames.xml` declared `PetFrame`,
+        // and so does the stock `PetFrame.xml`, so adding that stock file alongside ours would have
+        // declared the name twice. (That pair is resolved — ours is deleted — but the check is not
+        // about those two files; every window still ahead of 1751 has the same collision waiting.)
         // Several stock windows we do not ship under their own name have an equivalent of ours
         // under a different one, and `chain_gap_report` calls every one of them unblocked —
         // truthfully, because the stock file WOULD load; it just cannot load *beside* ours.
@@ -1442,17 +1446,6 @@ mod tests {
                 "the twin of the line above, `QuestLogFrame.lua:107`, called on the next line \
                  (`QuestTimerFrame.lua:44`).",
             ),
-            (
-                "UnitFrame.xml",
-                "UnitPlayerControlled",
-                "an engine binding, and the most reachable gap here: `UnitFrame_OnEnter` \
-                 (`UnitFrame.lua:62`) calls it while HOVERING any unit frame, behind \
-                 `SHOW_NEWBIE_TIPS == \"1\"` — which is the shipped default. wow-re has it carved \
-                 (`0x516410`, VERIFIED, `scratch/unit-verbs-controlled-charmed-creaturetype.md`): \
-                 one return, `UNIT_FIELD_FLAGS` bit 3, the DOUBLE 1.0 when set and nil when clear, \
-                 raising on an unrecognised token. `UnitState` carries no such flag yet, so it is \
-                 a field + a push + a binding — the unit frames' own slice.",
-            ),
         ];
 
         let toc = &super::super::addons::Addon::builtin().toc.files;
diff --git a/crates/benilla-app/src/ui_script/shipped_xml_tests.rs b/crates/benilla-app/src/ui_script/shipped_xml_tests.rs
index a9806d7d..fb197a4b 100644
--- a/crates/benilla-app/src/ui_script/shipped_xml_tests.rs
+++ b/crates/benilla-app/src/ui_script/shipped_xml_tests.rs
@@ -736,9 +736,10 @@ fn no_shipped_script_sets_a_global_string_key_as_display_text() {
 /// otherwise lift an ARTWORK bar fill straight over BACKGROUND art.
 ///
 /// Decision 0884 pinned the layer as bucket-wide and above the frame. Two files had been getting
-/// this right for the wrong reason — `UnitFrames.xml` and `PartyFrame.xml` both *declared* the
+/// this right for the wrong reason — our `UnitFrames.xml` and `PartyFrame.xml` both *declared* the
 /// TextureFrame after the bars and leaned on the retired key's insertion-order tie-break — so both
-/// inverted the instant the key was corrected, and both reached the director's screen. The
+/// inverted the instant the key was corrected, and both reached the director's screen. (Both files
+/// are retired now, 1751; the lesson is kept because it is about the KEY, not about them.) The
 /// reference spends a real frame level on this in both of its own spellings (`TargetFrame.lua`
 /// l.32-34's explicit `SetFrameLevel(textureFrame-1)`, `PlayerFrame.xml` l.50-52's two anonymous
 /// nesting frames); benilla now uses the first, everywhere.
@@ -760,7 +761,15 @@ fn every_texture_frame_outranks_its_status_bars() {
     assert!(failures.is_empty(), "manifest load errors: {failures:#?}");
     // Every unit-frame family painting at once: the frames hide themselves without a unit, and a
     // hidden frame emits no quads to read a level from.
-    for unit in ["player", "target", "party1", "party2", "party3", "party4"] {
+    for unit in [
+        "player",
+        "target",
+        "targettarget",
+        "party1",
+        "party2",
+        "party3",
+        "party4",
+    ] {
         s.set_unit(
             unit,
             Some(benilla_ui::script::UnitState {
@@ -778,6 +787,13 @@ fn every_texture_frame_outranks_its_status_bars() {
     }
     s.fire_event("PLAYER_ENTERING_WORLD", vec![]);
     s.fire_event("PARTY_MEMBERS_CHANGED", vec![]);
+    // The target-of-target frame ships OFF (`SHOW_TARGET_OF_TARGET = "0"`, the reference's own
+    // default, declared in OptionsFrame.xml which the manifest above has just loaded). Turn it on
+    // here: it is the SECOND of the two named TextureFrames the reference spells this way, and a
+    // gate that only ever sees the first covers half of what it claims to.
+    s.run(r#"SHOW_TARGET_OF_TARGET = "1""#).unwrap();
+    s.run("this = TargetofTargetFrame TargetofTarget_Update() this = nil")
+        .unwrap();
     s.resolve();
 
     // owner frame name → its (strata, level), read off the packed draw key the renderer sorts by.
@@ -812,18 +828,22 @@ fn every_texture_frame_outranks_its_status_bars() {
             checked += 1;
         }
     }
-    // Player + target (health/power) and four party members (health/mana) — never let this pass by
-    // matching nothing, which is exactly how a renamed frame would silently retire the check.
+    // **The predicted reduction, arrived.** This asserted 12 while the unit frames were ours,
+    // because our transcription spelled the idiom with a named `$parentTextureFrame` on EVERY
+    // family. The reference does not: it has exactly TWO named ones, `TargetFrameTextureFrame` and
+    // `TargetofTargetTextureFrame`, both in TargetFrame.xml. `PlayerFrame`, `PetFrame` and the
+    // party rows reach the same order the other way — the art inside ANONYMOUS nested
+    // `<Frame setAllPoints="true">` wrappers, outranking the bars by nesting depth rather than by
+    // a level on a name. There is nothing for a name sweep to look up, so those families move from
+    // this assertion's cover to the loader's nesting rule.
     //
-    // **This number drops to 6 the day `PartyFrame.xml` goes to the chain, and that will be a real
-    // reduction rather than a rename.** Stock `PartyFrameTemplates.xml` has no
-    // `$parentTextureFrame` at all: it gets the same result a different way, with the art inside a
-    // pair of ANONYMOUS nested `<Frame setAllPoints="true">` wrappers, so it outranks the bars by
-    // nesting depth rather than by a level on a named frame. There is nothing to look up, so the
-    // party rows will move from this assertion's cover to the loader's nesting rule. Written down
-    // now, while the reason is in front of somebody, rather than discovered as a number to lower.
+    // The note above this line predicted the drop when PartyFrame went to the chain and called it
+    // "a real reduction rather than a rename". That was right, and it under-counted: the whole kit
+    // went at once, so player and pet left by the same door. Two families × (HealthBar, ManaBar,
+    // ManaBar) = 6 is the reference's own coverage, and it is the floor now. Still never zero —
+    // matching nothing is exactly how a renamed frame would silently retire the check.
     assert!(
-        checked >= 12,
+        checked >= 6,
         "only {checked} texture-frame/bar pairs checked — the name sweep found nothing"
     );
     assert!(s.errors().is_empty(), "script errors: {:?}", s.errors());
diff --git a/crates/benilla-app/src/ui_script/target_aura_tests.rs b/crates/benilla-app/src/ui_script/target_aura_tests.rs
index 180801ab..4ff6f604 100644
--- a/crates/benilla-app/src/ui_script/target_aura_tests.rs
+++ b/crates/benilla-app/src/ui_script/target_aura_tests.rs
@@ -1,13 +1,16 @@
-//! The target frame's aura rows (`assets/ui/UnitFrames.xml`, decision 0255's deferred slice)
-//! against the reference's `TargetDebuffButton_Update` law (ref-TargetFrame.lua l.263-387). The
-//! XML/Lua is the unit under test; the app-side feed (`crate::ui_aura`'s target half) is stubbed
-//! by pushing an [`AuraState`] list through [`UiScript::set_auras`] and firing the events the feed
-//! fires — `PLAYER_TARGET_CHANGED` on a switch, `UNIT_AURA "target"` on a list change.
+//! The target frame's aura rows — the **reference's own** `Interface\FrameXML\TargetFrame.xml`
+//! off the player's patch chain (decision 1751, which retired our `assets/ui/UnitFrames.xml`
+//! transcription) — against its `TargetDebuffButton_Update` law (ref TargetFrame.lua l.263-387).
+//! The stock XML/Lua is the unit under test; the app-side feed (`crate::ui_aura`'s target half) is
+//! stubbed by pushing an [`AuraState`] list through [`UiScript::set_auras`] and firing the events
+//! the feed fires — `PLAYER_TARGET_CHANGED` on a switch, `UNIT_AURA "target"` on a list change.
 //!
 //! Under test: the friend/hostile row swap (buffs first vs debuffs first), the 21→17 shrink when
 //! the debuff count reaches the wrap (6, no target-of-target frame), the dispel-tinted border, the
-//! stack count, and the hide-on-empty lifecycle. Files load in the app's own order (UnitFrames
-//! before BuffFrame), which also pins the `DebuffTypeColor` late-definition contract.
+//! stack count, and the hide-on-empty lifecycle. Files load in `benilla.toc`'s order, which is the
+//! reference's own (BuffFrame 40 → CombatFeedback 41 → UnitFrame 43 → PlayerFrame 44 → PartyFrame
+//! 45 → TargetFrame 46 → PetFrame 47), so `DebuffTypeColor` is defined ahead of the row that
+//! indexes it and `RefreshBuffs` ahead of the party rows that call it from their own OnLoad.
 
 use benilla_ui::script::{AuraState, QuadContent, ScriptValue, UiScript, UnitState};
 
@@ -18,12 +21,31 @@ fn harness() -> UiScript {
     s.set_screen_size(1024.0, 768.0);
     load_xml(&s, "Fonts.xml");
     load_xml(&s, "GameTooltip.xml"); // TOOLTIP_DEFAULT_* (the dropdown kit's MenuBackdrop)
-    load_xml(&s, "UIDropDownMenu.xml"); // the unit popups' kit (UnitFrames' DropDown children)
+    load_xml(&s, "UIDropDownMenu.xml"); // the unit popups' kit (TargetFrameDropDown's template)
     load_xml(&s, "UnitPopup.xml");
     load_xml(&s, "Cooldown.xml");
     load_xml(&s, "ActionBar.xml"); // BENILLA_FALLBACK_ICON
-    load_xml(&s, "UnitFrames.xml"); // loads BEFORE BuffFrame, as in the app
-    load_xml(&s, "Interface\\FrameXML\\BuffFrame.xml"); // DebuffTypeColor
+    load_xml(&s, "UIParent.xml");
+    load_xml(&s, "Interface\\FrameXML\\TextStatusBar.lua");
+    load_xml(&s, "Interface\\FrameXML\\TextStatusBar.xml");
+    load_xml(&s, "Interface\\FrameXML\\BuffFrame.xml");
+    load_xml(&s, "Interface\\FrameXML\\UnitFrame.xml");
+    load_xml(&s, "Interface\\FrameXML\\CombatFeedback.xml");
+    load_xml(&s, "Interface\\FrameXML\\PlayerFrame.xml");
+    load_xml(&s, "Interface\\FrameXML\\PartyFrame.xml");
+    load_xml(&s, "Interface\\FrameXML\\TargetFrame.xml");
+    load_xml(&s, "Interface\\FrameXML\\PetFrame.xml");
+
+    // **Settle the target-of-target frame before any of this measures a row.** Stock
+    // `TargetofTargetFrame` carries no `hidden=` (ref TargetFrame.xml l.515), so it loads SHOWN,
+    // and the only thing that takes it down is `TargetofTarget_Update` — which
+    // `TargetFrame_OnEvent` runs *after* `TargetDebuffButton_Update` (ref TargetFrame.lua l.63-66,
+    // the update sitting inside `TargetFrame_Update` at l.51). So the very first target a freshly
+    // loaded client acquires lays its aura rows out for the 5-wide wrap, and only the next
+    // `TargetDebuffButton_Update` corrects them. One no-target `PLAYER_TARGET_CHANGED` runs that
+    // ladder to its end — exactly what deselecting once does — and leaves the frame in the state
+    // it holds for every target after the first, which is the state these tests are about.
+    s.fire_event("PLAYER_TARGET_CHANGED", vec![]);
     s
 }
 
diff --git a/crates/benilla-app/src/ui_script/test_ui.rs b/crates/benilla-app/src/ui_script/test_ui.rs
index ba984255..e8c8361c 100644
--- a/crates/benilla-app/src/ui_script/test_ui.rs
+++ b/crates/benilla-app/src/ui_script/test_ui.rs
@@ -141,7 +141,19 @@ pub(super) const LOOT_UI: &[&str] = &[
     "GameTooltip.xml", // TOOLTIP_DEFAULT_COLOR, read by the dropdown backdrop
     "UIDropDownMenu.xml", // GroupLootDropDown's OnLoad calls UIDropDownMenu_Initialize
     "UnitPopup.xml",
-    "PartyFrame.xml",
+    // …and what its rows' OnLoad calls: every `PartyMemberFrame<N>` and its pet frame runs
+    // `UnitFrame_Initialize`, which lives in UnitFrame.lua and itself calls
+    // `SetTextStatusBarText` out of TextStatusBar.lua. Naming PartyFrame without these loads
+    // four rows that each raise on their own OnLoad — the loader reports it, but only because
+    // `load_ui_strict` looks; a plain load would have gone quiet.
+    "Interface\\FrameXML\\TextStatusBar.lua",
+    "Interface\\FrameXML\\TextStatusBar.xml",
+    "Interface\\FrameXML\\UnitFrame.xml",
+    // …and `RefreshBuffs`, which `PartyMemberFrame.lua:60` calls from each row's OnLoad. Its home
+    // is BuffFrame.lua, which the chain's BuffFrame.xml sources — the reference's own toc has
+    // BuffFrame at 40 and PartyFrame at 45 for exactly this reason.
+    "Interface\\FrameXML\\BuffFrame.xml",
+    "Interface\\FrameXML\\PartyFrame.xml",
 ];
 
 /// What the **character window** needs before `Interface\FrameXML\CharacterFrame.xml`,
@@ -156,10 +168,13 @@ pub(super) const LOOT_UI: &[&str] = &[
 ///   three times before doing anything else. Its `.xml` twin comes too, because the pet page's XP
 ///   bar inherits the `TextStatusBar` template it declares and a missing template is a loader
 ///   *warning* — the bar would load with no art and no text region and read as a pass.
-/// * **`UnitFrames.xml`** for `PlayerFrameHealthBar` / `PlayerFrameManaBar`, the frames those three
-///   calls name, plus `PetFrameHealthBar` / `PetFrameManaBar` which `CharacterFrame_OnShow` shows
-///   the text on. (Ours: the unit frames are not migrated. When they are, this entry becomes the
-///   stock `PlayerFrame.xml` / `PetFrame.xml` pair.)
+/// * **`Interface\FrameXML\PlayerFrame.xml`** for `PlayerFrameHealthBar` / `PlayerFrameManaBar`,
+///   the frames those three calls name, and **`PetFrame.xml`** for `PetFrameHealthBar` /
+///   `PetFrameManaBar`, which `CharacterFrame_OnShow` shows the text on. Both call
+///   `UnitFrame_Initialize` in their OnLoad and `PlayerFrame` also calls `CombatFeedback_Initialize`,
+///   so `UnitFrame.xml` and `CombatFeedback.xml` come first — the reference's own toc order.
+///   (This entry used to be our one `UnitFrames.xml`, and this note used to say "when they are
+///   migrated, this becomes the stock pair". They are; it did.)
 /// * **`ActionBar.xml`** for `MainMenuExpBar` — the third bar of that prefix call — and for
 ///   `ShowWatchedReputationBarText` / `HideWatchedReputationBarText`, which the window's
 ///   show/hide pair calls.
@@ -199,7 +214,18 @@ pub(super) const CHARACTER_UI: &[&str] = &[
     "UnitPopup.xml",
     "Interface\\FrameXML\\TextStatusBar.lua",
     "Interface\\FrameXML\\TextStatusBar.xml",
-    "UnitFrames.xml",
+    // `UnitFrame_Initialize` and `CombatFeedback_Initialize`, which the two windows below call in
+    // their OnLoad. Neither file declares a frame; both are pure script.
+    "Interface\\FrameXML\\UnitFrame.xml",
+    "Interface\\FrameXML\\CombatFeedback.xml",
+    "Interface\\FrameXML\\PlayerFrame.xml",
+    // `PetFrame.xml`'s four `PetFrameBuff*` inherit `PartyBuffButtonTemplate`, which lives here.
+    // The manifest never names this file: it arrives through `PartyFrame.xml`'s
+    // `<Include file="PartyFrameTemplates.xml"/>`, and the reference's own toc puts PartyFrame (45)
+    // ahead of TargetFrame (46) and PetFrame (47) for exactly that reason. This kit wants the
+    // template and not four party member frames, so it takes the included file directly.
+    "Interface\\FrameXML\\PartyFrameTemplates.xml",
+    "Interface\\FrameXML\\PetFrame.xml",
     "ActionBar.xml",
     "MicroMenu.xml",
     // The two page files these three need before the window can be OPENED, which is not the same
diff --git a/crates/benilla-app/src/ui_script/tooltip_anchor_tests.rs b/crates/benilla-app/src/ui_script/tooltip_anchor_tests.rs
index 8413c53a..9846c974 100644
--- a/crates/benilla-app/src/ui_script/tooltip_anchor_tests.rs
+++ b/crates/benilla-app/src/ui_script/tooltip_anchor_tests.rs
@@ -89,9 +89,31 @@ fn world_hover_seats_the_default_corner() {
 #[test]
 fn unit_frame_hover_takes_the_default_corner_and_drops_on_leave() {
     // The kit + popups precede the unit frames (their DropDown children's OnLoad), app order.
-    let mut s = harness(&["UIDropDownMenu.xml", "UnitPopup.xml", "UnitFrames.xml"]);
+    let mut s = harness(&[
+        // The stock unit frames resolve GlobalStrings at LOAD (`CombatFeedback.lua` l.7-17,
+        // `UnitFrame.lua` l.1-6) and `UnitFrame_OnEnter` passes `PARTY_OPTIONS_LABEL` /
+        // `PLAYER_OPTIONS_LABEL` (l.60/63) straight into `GameTooltip:SetText`, which raises on
+        // nil. The app loads this file ahead of the whole manifest; so does the fixture.
+        "Interface\\FrameXML\\GlobalStrings.lua",
+        "Interface\\FrameXML\\TextStatusBar.lua",
+        "Interface\\FrameXML\\TextStatusBar.xml",
+        "UIDropDownMenu.xml",
+        "UnitPopup.xml",
+        "Interface\\FrameXML\\BuffFrame.xml",
+        "Interface\\FrameXML\\UnitFrame.xml",
+        "Interface\\FrameXML\\CombatFeedback.xml",
+        "Interface\\FrameXML\\PlayerFrame.xml",
+        "Interface\\FrameXML\\PartyFrame.xml",
+        "Interface\\FrameXML\\TargetFrame.xml",
+        "Interface\\FrameXML\\PetFrame.xml",
+    ]);
     s.set_unit("target", Some(wolf()));
-    s.run("BenillaUnitFrame_OnEnter(TargetFrame)").unwrap();
+    // The reference's handler takes no arguments and reads `this` (ref UnitFrame.lua l.45), which
+    // is exactly how the stock frames wire it: `<OnEnter>UnitFrame_OnEnter();</OnEnter>`
+    // (ref TargetFrame.xml l.505, PlayerFrame.xml l.435). Our deleted transcription's
+    // `BenillaUnitFrame_OnEnter(frame)` adapter went with the file.
+    s.run("this = TargetFrame UnitFrame_OnEnter() this = nil")
+        .unwrap();
     assert!(s.errors().is_empty(), "hover errors: {:?}", s.errors());
     s.resolve();
     let ok: bool = s
@@ -113,7 +135,8 @@ fn unit_frame_hover_takes_the_default_corner_and_drops_on_leave() {
         "a non-player target still gets the unit lines"
     );
     // Leave: gone on the spot, no ramp to wait out.
-    s.run("BenillaUnitFrame_OnLeave(TargetFrame)").unwrap();
+    s.run("this = TargetFrame UnitFrame_OnLeave() this = nil")
+        .unwrap();
     let hidden: bool = s.eval("return not GameTooltip:IsShown()").unwrap();
     assert!(
         hidden,
@@ -132,10 +155,28 @@ fn unit_frame_hover_takes_the_default_corner_and_drops_on_leave() {
 /// (the sibling test above).
 #[test]
 fn your_own_portrait_explains_the_menu_instead_of_showing_your_health() {
-    let mut s = harness(&["UIDropDownMenu.xml", "UnitPopup.xml", "UnitFrames.xml"]);
+    let mut s = harness(&[
+        // The stock unit frames resolve GlobalStrings at LOAD (`CombatFeedback.lua` l.7-17,
+        // `UnitFrame.lua` l.1-6) and `UnitFrame_OnEnter` passes `PARTY_OPTIONS_LABEL` /
+        // `PLAYER_OPTIONS_LABEL` (l.60/63) straight into `GameTooltip:SetText`, which raises on
+        // nil. The app loads this file ahead of the whole manifest; so does the fixture.
+        "Interface\\FrameXML\\GlobalStrings.lua",
+        "Interface\\FrameXML\\TextStatusBar.lua",
+        "Interface\\FrameXML\\TextStatusBar.xml",
+        "UIDropDownMenu.xml",
+        "UnitPopup.xml",
+        "Interface\\FrameXML\\BuffFrame.xml",
+        "Interface\\FrameXML\\UnitFrame.xml",
+        "Interface\\FrameXML\\CombatFeedback.xml",
+        "Interface\\FrameXML\\PlayerFrame.xml",
+        "Interface\\FrameXML\\PartyFrame.xml",
+        "Interface\\FrameXML\\TargetFrame.xml",
+        "Interface\\FrameXML\\PetFrame.xml",
+    ]);
     s.set_unit("player", Some(wolf()));
 
-    s.run("BenillaUnitFrame_OnEnter(PlayerFrame)").unwrap();
+    s.run("this = PlayerFrame UnitFrame_OnEnter() this = nil")
+        .unwrap();
     assert_eq!(
         s.eval::<String>("return GameTooltipTextLeft1:GetText()")
             .unwrap(),
@@ -160,11 +201,13 @@ fn your_own_portrait_explains_the_menu_instead_of_showing_your_health() {
         "target",
         Some(UnitState {
             is_player: true,
+            player_controlled: true,
             name: Some("Someone".into()),
             ..wolf()
         }),
     );
-    s.run("BenillaUnitFrame_OnEnter(TargetFrame)").unwrap();
+    s.run("this = TargetFrame UnitFrame_OnEnter() this = nil")
+        .unwrap();
     assert_eq!(
         s.eval::<String>("return GameTooltipTextLeft1:GetText()")
             .unwrap(),
@@ -313,6 +356,8 @@ fn buff_hover_hangs_below_left_of_the_button() {
     let mut s = harness(&[
         "Cooldown.xml",
         "ActionBar.xml",
+        "Interface\\FrameXML\\TextStatusBar.lua",
+        "Interface\\FrameXML\\TextStatusBar.xml",
         "Interface\\FrameXML\\BuffFrame.xml",
     ]);
     s.set_auras(
diff --git a/crates/benilla-app/src/ui_script/tot_frame_tests.rs b/crates/benilla-app/src/ui_script/tot_frame_tests.rs
index c42dd2c0..aa8ec2a7 100644
--- a/crates/benilla-app/src/ui_script/tot_frame_tests.rs
+++ b/crates/benilla-app/src/ui_script/tot_frame_tests.rs
@@ -1,14 +1,26 @@
-//! The shipped target-of-target frame, driven end to end (decision 1576) — `UnitFrames.xml`'s
-//! `TargetofTargetFrame` over synthetic `"targettarget"` snapshots and the events the app's feed
-//! fires for that token.
+//! The target-of-target frame, driven end to end (decision 1576) — the **reference's own**
+//! `TargetofTargetFrame`, declared in `Interface\FrameXML\TargetFrame.xml` (l.515-680) and
+//! driven by `TargetFrame.lua`, off the player's patch chain. Decision 1751 retired our
+//! `assets/ui/UnitFrames.xml` transcription, so what is under test here is the stock file over
+//! synthetic `"targettarget"` snapshots.
 //!
-//! Two things here are not ordinary unit-frame plumbing and are what most of these test:
+//! Three things here are not ordinary unit-frame plumbing and are what most of these test:
 //!
 //! * **The visibility law is six gates deep** — a switch, five display modes, and the four unit
 //!   tests the reference wraps them in — and a frame that gets any of them wrong is either always
-//!   there or never there. The mode leg is also where we knowingly leave the reference: its solo
-//!   arm calls neither `Show` nor `Hide` when you are in a raid, so the frame keeps whatever state
-//!   it had; ours answers the question the option asks.
+//!   there or never there. The mode leg leaks by construction: its solo arm calls neither `Show`
+//!   nor `Hide` when you are in a raid (ref TargetFrame.lua l.513-520), so the frame keeps
+//!   whatever state it had. Our transcription closed that; the stock file is the end state, so the
+//!   leak is now the behaviour under test.
+//! * **Nothing on this frame is event-driven.** Its bars carry no `OnEvent` at all (ref
+//!   TargetFrame.xml l.593-625 — the health bar has only `OnValueChanged`, the mana bar no
+//!   `<Scripts>` block), so the `UNIT_HEALTH`/`UNIT_MANA` registrations
+//!   `UnitFrameHealthBar_Initialize`/`UnitFrameManaBar_Initialize` make (ref UnitFrame.lua
+//!   l.150-151, l.190-200) are dead, and so is the frame's own `UNIT_AURA` registration (ref
+//!   TargetFrame.xml l.668) — `UnitFrame_OnEvent` handles three events and that is not one of
+//!   them. `TargetofTarget_OnUpdate` → `TargetofTarget_Update` is the only driver of the name, the
+//!   bars, the dead word, the portrait tint and the aura row. **That is why nearly every step in
+//!   this file is a `tick`, not a `fire_event`.**
 //! * **A token going away is silent.** The feed clears `"targettarget"` without an event, by the
 //!   same convention `"target"` uses, so the frame's own events cannot take it down — that is what
 //!   `TargetFrame_OnUpdate`'s one-compare reconcile is for, and it has a test.
@@ -41,10 +53,10 @@ fn unit(name: &str, guid: u64, health: u32) -> UnitState {
 /// The frame's production load prefix, plus a player, a target and a target's target — the state
 /// in which everything but the switch itself already allows the frame.
 ///
-/// The tail three are the target-aura tests' set and are here for the same reasons: `BuffFrame`
-/// defines `DebuffTypeColor`, which the debuff row's dispel tint indexes, and it will not TICK
-/// without `ActionBar`'s `TOOLTIP_UPDATE_TIME` — which this file's reconcile test needs, since it
-/// is the only one here that runs the clock.
+/// The tail is the target-aura tests' set and is here for the same reasons: `BuffFrame` defines
+/// `DebuffTypeColor`, which the debuff row's dispel tint indexes, and it will not TICK without
+/// `ActionBar`'s `TOOLTIP_UPDATE_TIME` — which almost every test in this file needs, because the
+/// stock frame is driven from its OnUpdate and nowhere else (see the module doc).
 fn load_tot() -> UiScript {
     let mut s = UiScript::new().unwrap();
     s.set_screen_size(1024.0, 768.0);
@@ -55,8 +67,21 @@ fn load_tot() -> UiScript {
     load_xml(&s, "UnitPopup.xml");
     load_xml(&s, "Cooldown.xml");
     load_xml(&s, "ActionBar.xml");
-    load_xml(&s, "UnitFrames.xml");
+    load_xml(&s, "Interface\\FrameXML\\TextStatusBar.lua");
+    load_xml(&s, "Interface\\FrameXML\\TextStatusBar.xml");
     load_xml(&s, "Interface\\FrameXML\\BuffFrame.xml");
+    load_xml(&s, "Interface\\FrameXML\\UnitFrame.xml");
+    load_xml(&s, "Interface\\FrameXML\\CombatFeedback.xml");
+    load_xml(&s, "Interface\\FrameXML\\PlayerFrame.xml");
+    load_xml(&s, "Interface\\FrameXML\\PartyFrame.xml");
+    load_xml(&s, "Interface\\FrameXML\\TargetFrame.xml");
+    load_xml(&s, "Interface\\FrameXML\\PetFrame.xml");
+    // The target-of-target pair's home is `OptionsFrame.xml` (the reference keeps them in
+    // `UIOptionsFrame.lua`'s uvar defaults block, l.116-119). That file sits at the BOTTOM of our
+    // manifest where the reference's sits near the top, so a test that loads the unit kit alone
+    // has to state them itself — the same thing this harness already does for `DEAD`.
+    s.run(r#"SHOW_TARGET_OF_TARGET = "0" SHOW_TARGET_OF_TARGET_STATE = "5""#)
+        .unwrap();
     s.set_unit("player", Some(unit("Tri", 0x100, 100)));
     s.set_unit("target", Some(unit("Kobold Miner", 0x200, 80)));
     s.set_unit("targettarget", Some(unit("Tri", 0x100, 100)));
@@ -66,7 +91,7 @@ fn load_tot() -> UiScript {
 
 /// Turn the frame on the way the option row does — the write plus its `applyFunc`.
 fn switch_on(s: &mut UiScript) {
-    s.run(r#"SHOW_TARGET_OF_TARGET = "1" TargetofTarget_Update()"#)
+    s.run(r#"SHOW_TARGET_OF_TARGET = "1" this = TargetofTargetFrame TargetofTarget_Update() this = nil"#)
         .unwrap();
 }
 
@@ -163,37 +188,47 @@ fn the_four_unit_gates_each_take_the_frame_down() {
 
     // No target of target.
     s.set_unit("targettarget", None);
-    s.run("TargetofTarget_Update()").unwrap();
+    s.run("this = TargetofTargetFrame TargetofTarget_Update() this = nil")
+        .unwrap();
     assert!(!shown(&mut s), "nothing to show");
     s.set_unit("targettarget", Some(unit("Tri", 0x100, 100)));
 
     // No target at all.
     s.set_unit("target", None);
-    s.run("TargetofTarget_Update()").unwrap();
+    s.run("this = TargetofTargetFrame TargetofTarget_Update() this = nil")
+        .unwrap();
     assert!(!shown(&mut s), "no target, no target's target");
     s.set_unit("target", Some(unit("Kobold Miner", 0x200, 80)));
 
     // The target is YOU: its target is your own target, and the frame would restate the frame it
     // hangs off.
     s.set_unit("target", Some(unit("Tri", 0x100, 100)));
-    s.run("TargetofTarget_Update()").unwrap();
+    s.run("this = TargetofTargetFrame TargetofTarget_Update() this = nil")
+        .unwrap();
     assert!(!shown(&mut s), "self-target: nothing to add");
     s.set_unit("target", Some(unit("Kobold Miner", 0x200, 80)));
 
     // A dead target.
     s.set_unit("target", Some(unit("Kobold Miner", 0x200, 0)));
-    s.run("TargetofTarget_Update()").unwrap();
+    s.run("this = TargetofTargetFrame TargetofTarget_Update() this = nil")
+        .unwrap();
     assert!(!shown(&mut s), "a corpse is fighting nobody");
 
     s.set_unit("target", Some(unit("Kobold Miner", 0x200, 80)));
-    s.run("TargetofTarget_Update()").unwrap();
+    s.run("this = TargetofTargetFrame TargetofTarget_Update() this = nil")
+        .unwrap();
     assert!(shown(&mut s), "and back");
     assert!(s.errors().is_empty(), "script errors: {:?}", s.errors());
 }
 
-/// The five display modes, each against solo / party / raid. Mode 3 in a raid is the one that
-/// diverges from the reference on purpose: its ladder calls neither Show nor Hide there and the
-/// frame keeps its last state (ref l.513-520), which is a leak rather than a rule.
+/// The five display modes, each against solo / party / raid.
+///
+/// Mode 3 in a raid is not a rule the ladder states — it is the hole in it. The
+/// `SHOW_TARGET_OF_TARGET_STATE == "3"` arm acts only while `GetNumRaidMembers() == 0` (ref
+/// TargetFrame.lua l.513-520), so in a raid it calls neither Show nor Hide and the frame keeps
+/// whatever it had. It reads `false` here because the preceding `party` step left it hidden, and
+/// that sequencing is the only reason. The leak itself is
+/// [`the_solo_mode_keeps_the_frame_when_a_raid_forms`], which shows the frame first.
 #[test]
 fn the_five_modes_answer_solo_party_and_raid() {
     let mut s = load_tot();
@@ -216,7 +251,7 @@ fn the_five_modes_answer_solo_party_and_raid() {
         for (i, (label, state)) in states.iter().enumerate() {
             s.set_party(state.clone());
             s.run(&format!(
-                r#"SHOW_TARGET_OF_TARGET_STATE = "{mode}" TargetofTarget_Update()"#
+                r#"SHOW_TARGET_OF_TARGET_STATE = "{mode}" this = TargetofTargetFrame TargetofTarget_Update() this = nil"#
             ))
             .unwrap();
             assert_eq!(
@@ -230,28 +265,60 @@ fn the_five_modes_answer_solo_party_and_raid() {
     assert!(s.errors().is_empty(), "script errors: {:?}", s.errors());
 }
 
-/// Mode 3 in a raid, specifically as a STATE question rather than a fresh evaluation: the frame
-/// must come down when the raid forms, not keep whatever it had. This is the reference's leaked
-/// branch, and it can only be seen by showing the frame first.
+/// Mode 3 in a raid, as a STATE question rather than a fresh evaluation — the leaked branch, which
+/// can only be seen by showing the frame first.
+///
+/// **This assertion flipped with 1751.** Our deleted `UnitFrames.xml` answered the question the
+/// option asks and took the frame down; the stock file does not. `TargetofTarget_Update`'s
+/// `SHOW_TARGET_OF_TARGET_STATE == "3"` arm is `if ( GetNumRaidMembers() == 0 ) then … end` with
+/// no `else` (ref TargetFrame.lua l.513-520), so in a raid it reaches neither `Show` nor `Hide`
+/// and the frame keeps whatever it had. The stock file is the end state, so the reference's answer
+/// is the assertion.
+///
+/// Driven by a `tick`, which is the strong form: `TargetofTarget_OnUpdate` re-runs
+/// `TargetofTarget_Update` on **every** frame (ref TargetFrame.xml l.673-675 → TargetFrame.lua
+/// l.500), so this is not one stale evaluation left standing — the reference re-asks the question
+/// sixty times a second and still never takes the frame down.
 #[test]
-fn the_solo_mode_comes_down_when_a_raid_forms() {
+fn the_solo_mode_keeps_the_frame_when_a_raid_forms() {
     let mut s = load_tot();
     switch_on(&mut s);
-    s.run(r#"SHOW_TARGET_OF_TARGET_STATE = "3" TargetofTarget_Update()"#)
+    s.run(r#"SHOW_TARGET_OF_TARGET_STATE = "3" this = TargetofTargetFrame TargetofTarget_Update() this = nil"#)
         .unwrap();
     assert!(shown(&mut s), "solo, in solo mode");
 
     s.set_party(raid(10));
-    s.fire_event("RAID_ROSTER_UPDATE", vec![]);
-    assert!(!shown(&mut s), "the raid forms and the frame goes away");
+    s.tick(0.016);
+    assert!(
+        shown(&mut s),
+        "the raid forms and the reference's solo arm never fires — the frame stays"
+    );
+    assert!(s.errors().is_empty(), "script errors: {:?}", s.errors());
 }
 
-/// The paint: name, health, and the powerless unit's hidden mana bar (this file's convention on
-/// every frame — the reference leaves an empty 0/0 rail drawn).
+/// The paint: name, health, and the powerless unit's mana rail — which the reference **never
+/// hides**.
+///
+/// **Two things flipped with 1751**, and both are the stock file being the end state:
+///
+/// * **The name arrives on a tick, not on the switch.** `TargetofTarget_Update` (ref
+///   TargetFrame.lua l.503-540) touches the bars, the dead word and the aura rows and never the
+///   name; the `SetText` lives in `TargetofTarget_OnUpdate`'s `CURRENT_TARGETTARGET` compare
+///   (l.494-501), off the frame's own OnUpdate. Turning the switch on alone leaves it nil.
+/// * **A powerless unit still gets a rail.** `UnitFrameManaBar_Update` (ref UnitFrame.lua
+///   l.203-224) sets 0..0 and calls neither `Show` nor `Hide` — there is no hide leg anywhere in
+///   the reference's mana path. Our deleted `UnitFrames.xml` hid the bar and this asserted that;
+///   the stock answer is an empty 0/0 rail, still drawn, so that is what is asserted now.
+///
+/// The powerless step is a `tick` for the same reason as everything else here: 1.12 has no
+/// `UNIT_MAXPOWER` event at all (the reference registers `UNIT_MAXMANA`/`RAGE`/`FOCUS`/`ENERGY`/
+/// `HAPPINESS`, ref UnitFrame.lua l.195-199), and this frame's mana bar carries no `OnEvent` to
+/// answer one with if it did (ref TargetFrame.xml l.612-625).
 #[test]
 fn the_frame_paints_its_unit() {
     let mut s = load_tot();
     switch_on(&mut s);
+    s.tick(0.016);
 
     assert_eq!(
         s.eval::<String>("return TargetofTargetName:GetText()")
@@ -274,24 +341,38 @@ fn the_frame_paints_its_unit() {
     let mut powerless = unit("Skeleton", 0x100, 100);
     powerless.max_power = 0;
     s.set_unit("targettarget", Some(powerless));
-    s.fire_event(
-        "UNIT_MAXPOWER",
-        vec![ScriptValue::Str("targettarget".into())],
-    );
+    s.tick(0.016);
     assert!(
-        !s.eval::<bool>("return TargetofTargetManaBar:IsShown() and true or false")
+        s.eval::<bool>("return TargetofTargetManaBar:IsShown() and true or false")
             .unwrap(),
-        "no power, no rail"
+        "no power, and the rail is STILL drawn — the reference has no hide leg"
+    );
+    assert_eq!(
+        s.eval::<(f64, f64)>(
+            "local _, m = TargetofTargetManaBar:GetMinMaxValues() \
+             return TargetofTargetManaBar:GetValue(), m",
+        )
+        .unwrap(),
+        (0.0, 0.0),
+        "it reads 0/0"
     );
     assert!(s.errors().is_empty(), "script errors: {:?}", s.errors());
 }
 
 /// DEAD over a dimmed trough — and the reference's connected test, which is what tells a corpse
-/// from a linkdead player (both read zero health).
+/// from a linkdead player (both read zero health). Ref `TargetofTarget_CheckDead`, TargetFrame.lua
+/// l.559-567.
+///
+/// Every step is a `tick` rather than a `UNIT_HEALTH`: `TargetofTargetHealthBar` registers that
+/// event through `UnitFrameHealthBar_Initialize` (ref UnitFrame.lua l.150) but declares **no**
+/// `OnEvent` to answer it with (ref TargetFrame.xml l.593-611 — `OnValueChanged` and nothing
+/// else), so the registration is dead and `TargetofTarget_Update` off the frame's OnUpdate is the
+/// only thing that ever calls `TargetofTarget_CheckDead`.
 #[test]
 fn the_dead_word_needs_a_connected_corpse() {
     let mut s = load_tot();
     switch_on(&mut s);
+    s.tick(0.016);
     assert!(
         !s.eval::<bool>("return TargetofTargetDeadText:IsShown() and true or false")
             .unwrap(),
@@ -301,7 +382,7 @@ fn the_dead_word_needs_a_connected_corpse() {
     let mut corpse = unit("Tri", 0x100, 0);
     corpse.dead = true;
     s.set_unit("targettarget", Some(corpse.clone()));
-    s.fire_event("UNIT_HEALTH", vec![ScriptValue::Str("targettarget".into())]);
+    s.tick(0.016);
     assert!(
         s.eval::<bool>("return TargetofTargetDeadText:IsShown() and true or false")
             .unwrap(),
@@ -311,7 +392,7 @@ fn the_dead_word_needs_a_connected_corpse() {
     let mut linkdead = corpse;
     linkdead.is_connected = false;
     s.set_unit("targettarget", Some(linkdead));
-    s.fire_event("UNIT_HEALTH", vec![ScriptValue::Str("targettarget".into())]);
+    s.tick(0.016);
     assert!(
         !s.eval::<bool>("return TargetofTargetDeadText:IsShown() and true or false")
             .unwrap(),
@@ -320,18 +401,24 @@ fn the_dead_word_needs_a_connected_corpse() {
     assert!(s.errors().is_empty(), "script errors: {:?}", s.errors());
 }
 
-/// The portrait tint (ref TargetofTargetHealthCheck), and its PLAYERS-ONLY gate: a creature's
-/// portrait is never tinted, which is why the check has to run off the bar's own value rather
-/// than off the snapshot.
+/// The portrait tint (ref `TargetofTargetHealthCheck`, TargetFrame.lua l.569-585), and its
+/// PLAYERS-ONLY gate: a creature's portrait is never tinted, which is why the check has to run off
+/// the bar's own value rather than off the snapshot.
+///
+/// Ticks, not `UNIT_HEALTH`, and here the chain is one link longer than the dead word's: the check
+/// hangs off the health bar's `OnValueChanged` (ref TargetFrame.xml l.604-608), and the only thing
+/// that moves that value is `UnitFrameHealthBar_Update` inside `TargetofTarget_Update` — which is
+/// reached from the frame's OnUpdate and nowhere else.
 #[test]
 fn the_portrait_tints_with_a_players_state_and_never_a_creatures() {
     let mut s = load_tot();
     switch_on(&mut s);
+    s.tick(0.016);
 
     let mut hurt = unit("Tri", 0x100, 15);
     hurt.is_player = true;
     s.set_unit("targettarget", Some(hurt));
-    s.fire_event("UNIT_HEALTH", vec![ScriptValue::Str("targettarget".into())]);
+    s.tick(0.016);
     let (r, g, b) = s
         .eval::<(f64, f64, f64)>("return TargetofTargetPortrait:GetVertexColor()")
         .unwrap();
@@ -340,7 +427,7 @@ fn the_portrait_tints_with_a_players_state_and_never_a_creatures() {
     let mut healthy = unit("Tri", 0x100, 90);
     healthy.is_player = true;
     s.set_unit("targettarget", Some(healthy));
-    s.fire_event("UNIT_HEALTH", vec![ScriptValue::Str("targettarget".into())]);
+    s.tick(0.016);
     let (r, g, b) = s
         .eval::<(f64, f64, f64)>("return TargetofTargetPortrait:GetVertexColor()")
         .unwrap();
@@ -348,7 +435,7 @@ fn the_portrait_tints_with_a_players_state_and_never_a_creatures() {
 
     // A creature at the same 15%: the tint must not move (the check returns before touching it).
     s.set_unit("targettarget", Some(unit("Kobold", 0x500, 15)));
-    s.fire_event("UNIT_HEALTH", vec![ScriptValue::Str("targettarget".into())]);
+    s.tick(0.016);
     let (r, g, b) = s
         .eval::<(f64, f64, f64)>("return TargetofTargetPortrait:GetVertexColor()")
         .unwrap();
@@ -374,7 +461,15 @@ fn the_left_click_targets_the_unit() {
     assert!(s.errors().is_empty(), "script errors: {:?}", s.errors());
 }
 
-/// The four debuff buttons, dispel-tinted (ref RefreshBuffs over MAX_PARTY_DEBUFFS).
+/// The four debuff buttons, dispel-tinted (ref `RefreshBuffs` over `MAX_PARTY_DEBUFFS`,
+/// BuffFrame.lua l.262-313, called from `TargetofTarget_Update` l.538).
+///
+/// The `UNIT_AURA` fire is what the feed really does and is kept for that reason, but it is inert
+/// here: the frame registers the event in its own OnLoad (ref TargetFrame.xml l.668) and answers
+/// it with `UnitFrame_OnEvent`, which handles `UNIT_NAME_UPDATE`, `UNIT_PORTRAIT_UPDATE` and
+/// `UNIT_DISPLAYPOWER` and nothing else (ref UnitFrame.lua l.31-45). A dead registration in the
+/// stock file — the row is redrawn by `RefreshBuffs` off the OnUpdate, so the `tick` is what makes
+/// it appear.
 #[test]
 fn the_debuff_row_draws_what_the_unit_carries() {
     let mut s = load_tot();
@@ -387,6 +482,7 @@ fn the_debuff_row_draws_what_the_unit_carries() {
         ]),
     );
     s.fire_event("UNIT_AURA", vec![ScriptValue::Str("targettarget".into())]);
+    s.tick(0.016);
 
     let paths = drawn(&mut s);
     assert!(
@@ -406,8 +502,13 @@ fn the_debuff_row_draws_what_the_unit_carries() {
 }
 
 /// The target's OWN aura rows re-wrap around this frame: 5 to a row instead of 6, and the buffs
-/// open under the second debuff row instead of the seventh icon (ref TargetDebuffButton_Update
-/// l.310-334). Both directions — the reference only re-runs the rows on the way in.
+/// open under the second debuff row instead of the seventh icon (ref `TargetDebuffButton_Update`,
+/// TargetFrame.lua l.312-338 for the wrap and l.370-385 for the row anchors).
+///
+/// Both directions, and they are not symmetric: the reference re-runs the rows on the way **in**
+/// only. `TargetDebuffButton_Update` is called from inside `TargetofTarget_Update`'s
+/// `if ( TargetofTargetFrame:IsShown() )` (l.532-537), so turning the frame off leaves the rows
+/// wrapped short behind it.
 #[test]
 fn the_target_rows_wrap_short_while_the_frame_stands_beside_them() {
     let mut s = load_tot();
@@ -440,13 +541,18 @@ fn the_target_rows_wrap_short_while_the_frame_stands_beside_them() {
         "and the sixth icon starts the second row"
     );
 
-    // Back off — the reference never re-lays the rows here, so they would stay wrapped short.
-    s.run(r#"SHOW_TARGET_OF_TARGET = "0" TargetofTarget_Update()"#)
+    // Back off — and the rows STAY wrapped short. **This assertion flipped with 1751.**
+    // `TargetofTarget_Update` calls `TargetDebuffButton_Update` from inside
+    // `if ( TargetofTargetFrame:IsShown() )` (ref TargetFrame.lua l.532-537), so the pass that
+    // hides the frame is exactly the pass that does not re-lay the target's rows. They keep the
+    // 5-wide wrap until something else runs the update — the next target change or `UNIT_AURA`.
+    // Our deleted `UnitFrames.xml` re-laid them on the way out; the stock file is the end state.
+    s.run(r#"SHOW_TARGET_OF_TARGET = "0" this = TargetofTargetFrame TargetofTarget_Update() this = nil"#)
         .unwrap();
     assert_eq!(
         anchor(&mut s, "TargetFrameBuff1"),
-        "TargetFrameDebuff7",
-        "and back to six"
+        "TargetFrameDebuff6",
+        "the frame goes and the rows are left wrapped short behind it"
     );
     assert!(s.errors().is_empty(), "script errors: {:?}", s.errors());
 }
diff --git a/crates/benilla-app/src/ui_script/unit_frame_tests.rs b/crates/benilla-app/src/ui_script/unit_frame_tests.rs
index 04295850..36d53e55 100644
--- a/crates/benilla-app/src/ui_script/unit_frame_tests.rs
+++ b/crates/benilla-app/src/ui_script/unit_frame_tests.rs
@@ -2,17 +2,23 @@ use benilla_ui::script::{
     QuadContent, ScriptValue, SelectionRequest, SoundRequest, UiScript, UnitState,
 };
 
-use super::test_ui::load_ui as load_xml;
+use super::test_ui::{hover, load_ui as load_xml, unhover};
 
 /// The unit frames' production load prefix (ui_script/mod.rs order): fonts + UIParent +
 /// tooltip, then the dropdown kit + unit popups the frames' DropDown children initialize into.
 fn load_unit_frames(s: &UiScript) {
-    // The app runs the real `Interface\FrameXML\GlobalStrings.lua` off the player's chain
-    // BEFORE any XML (`load_global_strings`); this stands in for it, with the one key these
-    // frames resolve at load time — `DEAD` l.898, which both dead-text FontStrings name in
-    // their `text=` attribute. Without it the loader's literal fallback would leave the KEY on
-    // screen, which is the bug this file guards below.
-    s.run(r#"DEAD = "Dead""#).unwrap();
+    // The app runs the real `Interface\FrameXML\GlobalStrings.lua` off the player's chain BEFORE
+    // any XML (`load_global_strings`), so the fixture names it too. This used to be a single
+    // hand-set `DEAD = "Dead"`, which was enough while the frames were OUR transcription: ours
+    // carried `X = X or "…"` fallbacks and hard literals for everything else. The reference's own
+    // files carry none, and they resolve GlobalStrings at LOAD in three separate places —
+    // `CombatFeedback.lua` l.7-17 builds the whole `CombatFeedbackText` table out of them
+    // (`TEXT(ABSORB)`, `TEXT(MISS)`, …), `UnitFrame.lua` l.1-6 builds `ManaBarColor`'s prefixes
+    // the same way, and `UnitFrame_OnEnter` l.60/63 passes `PARTY_OPTIONS_LABEL` /
+    // `PLAYER_OPTIONS_LABEL` straight into `GameTooltip:SetText`, which raises on nil rather than
+    // drawing an empty plate. Hand-setting the union of those is a second copy of the reference's
+    // own file; naming the file is the only version that cannot drift. (`DEAD` is l.898 of it.)
+    load_xml(s, "Interface\\FrameXML\\GlobalStrings.lua");
     load_xml(s, "Fonts.xml");
     load_xml(s, "UIParent.xml");
     // The bars' numerals machinery (decision 1082), which the manifest loads immediately ahead of
@@ -22,7 +28,13 @@ fn load_unit_frames(s: &UiScript) {
     load_xml(s, "GameTooltip.xml");
     load_xml(s, "UIDropDownMenu.xml");
     load_xml(s, "UnitPopup.xml");
-    load_xml(s, "UnitFrames.xml");
+    load_xml(s, "Interface\\FrameXML\\BuffFrame.xml");
+    load_xml(s, "Interface\\FrameXML\\UnitFrame.xml");
+    load_xml(s, "Interface\\FrameXML\\CombatFeedback.xml");
+    load_xml(s, "Interface\\FrameXML\\PlayerFrame.xml");
+    load_xml(s, "Interface\\FrameXML\\PartyFrame.xml");
+    load_xml(s, "Interface\\FrameXML\\TargetFrame.xml");
+    load_xml(s, "Interface\\FrameXML\\PetFrame.xml");
 }
 
 /// Load the real `assets/ui/UnitFrames.xml` (the shipped default UI) into a bare engine and
@@ -36,13 +48,31 @@ fn shipped_unit_frames_drive_end_to_end() {
     load_unit_frames(&s);
     assert!(s.errors().is_empty(), "script errors: {:?}", s.errors());
 
-    // No units yet: both frames hid themselves on their OnLoad's first update.
-    let hidden: bool = s
-        .eval("return not PlayerFrame:IsVisible() and not TargetFrame:IsVisible()")
+    // **Only the TARGET frame hides.** Our deleted transcription hid both; the reference hides
+    // exactly one. `PlayerFrame` is a plain top-level `<Button>` with no `hidden=` attribute
+    // (ref PlayerFrame.xml l.4) and `PlayerFrame_Update` (ref PlayerFrame.lua l.29-37) wraps its
+    // whole body in `if UnitExists("player")` without an else — nothing in the file ever calls
+    // `PlayerFrame:Hide()`. That is the real client's behaviour: the player plate is up from the
+    // moment the UI loads, empty until the player object arrives. `TargetFrame_Update`
+    // (ref TargetFrame.lua l.38-55) is the one with the `else this:Hide()`.
+    let shape: bool = s
+        .eval("return PlayerFrame:IsVisible() and not TargetFrame:IsVisible()")
         .unwrap();
-    assert!(hidden, "frames hide while their units don't exist");
+    assert!(
+        shape,
+        "the player plate is always up; only the target frame hides while its unit is absent"
+    );
 
     // The player appears (name still unresolved), at 72/100 health, 45/80 mana.
+    //
+    // `PLAYER_ENTERING_WORLD` is the event, not `UNIT_HEALTH`, and the reference is why: the
+    // stock bars each register their OWN events and repaint only themselves
+    // (`UnitFrameHealthBar_Initialize` takes UNIT_HEALTH/UNIT_MAXHEALTH, ref UnitFrame.lua
+    // l.150-151; `UnitFrameManaBar_Initialize` takes the ten UNIT_MANA/RAGE/… ones, l.189-199),
+    // so UNIT_HEALTH alone would leave the mana bar at its load-time 0/0. The one handler that
+    // repaints name + portrait + both bars together is `PlayerFrame_OnEvent`'s
+    // PLAYER_ENTERING_WORLD arm → `UnitFrame_Update()` (ref PlayerFrame.lua l.96-100), which is
+    // also what really fires when the player object arrives.
     s.set_unit(
         "player",
         Some(UnitState {
@@ -56,10 +86,14 @@ fn shipped_unit_frames_drive_end_to_end() {
             max_power: 80,
             dead: false,
             reaction: 0,
+            // Not decoration: `UnitFrameManaBar_Update`'s disconnect leg (ref UnitFrame.lua
+            // l.209-212) pins a disconnected unit's power bar to MAX and greys it, and
+            // `UnitState::default()` leaves this `false`.
+            is_connected: true,
             ..UnitState::default()
         }),
     );
-    s.fire_event("UNIT_HEALTH", vec![ScriptValue::Str("player".into())]);
+    s.fire_event("PLAYER_ENTERING_WORLD", vec![]);
     assert!(s.eval::<bool>("return PlayerFrame:IsVisible()").unwrap());
     let ok: bool = s
         .eval(
@@ -71,12 +105,24 @@ fn shipped_unit_frames_drive_end_to_end() {
             return hb:GetValue() == 72 and hmax == 100
                and pb:GetValue() == 45 and pmax == 80 and pb:IsVisible()
                and b == 1 and r == 0 -- mana blue
-               and PlayerName:GetText() == "Unknown"
         "#,
         )
         .unwrap();
     assert!(ok, "player frame painted from the snapshot");
 
+    // …and the name plate is BLANK while the name is unresolved, not the word "Unknown". That
+    // word was our transcription's, twice over — a `text="Unknown"` literal on the FontString
+    // (deleted UnitFrames.xml l.1364) and a `UnitName(unit) or "Unknown"` fallback (l.803). The
+    // reference's `PlayerName` carries no `text=` at all (ref PlayerFrame.xml l.58) and
+    // `GetUnitName` returns `UnitName`'s result unchanged (ref UnitFrame.lua l.226-236), so what
+    // shows is whatever the engine's `UnitName` returns for a nameless unit — nil here.
+    assert_eq!(
+        s.eval::<Option<String>>("return PlayerName:GetText()")
+            .unwrap(),
+        None,
+        "no name yet: the stock file has no \"Unknown\" literal to fall back on"
+    );
+
     // The name-query answer lands: UNIT_NAME_UPDATE repaints the name.
     s.set_unit(
         "player",
@@ -91,6 +137,7 @@ fn shipped_unit_frames_drive_end_to_end() {
             max_power: 80,
             dead: false,
             reaction: 0,
+            is_connected: true,
             ..UnitState::default()
         }),
     );
@@ -100,7 +147,21 @@ fn shipped_unit_frames_drive_end_to_end() {
         "Benilla"
     );
 
-    // A powerless wolf gets targeted: frame shows, power bar hides, health fills 30/50.
+    // A powerless wolf gets targeted: frame shows, power bar runs EMPTY, health fills 30/50.
+    //
+    // "Empty", not hidden — and the reason is a reference quirk worth knowing. The only thing in
+    // 1.12 that hides a StatusBar for having no track is `TextStatusBar_UpdateTextString`'s
+    // `else textStatusBar:Hide()` (ref TextStatusBar.lua l.55-57), and that whole body sits
+    // inside `if(string)` — `string` being `bar.TextString`. The reference **never declares**
+    // `TargetFrameHealthBarText` / `TargetFrameManaBarText`: TargetFrame.xml l.486-487 passes
+    // both names into `UnitFrame_Initialize` and neither exists anywhere in FrameXML (only the
+    // player's and the pet's do — PlayerFrame.xml l.79/88, PetFrame.xml l.87/96). So
+    // `SetTextStatusBarText` early-returns on the nil (ref TextStatusBar.lua l.7-10), the
+    // target's bars carry no `TextString`, and the hide can never fire. It doesn't show: these
+    // bars have a `<BarTexture>` and no background, so a 0/0 bar draws nothing either way.
+    //
+    // Our transcription hid it, because 1146 §3 *declared* the two text regions the reference
+    // leaves dangling. Those are gone with the file.
     s.set_unit(
         "target",
         Some(UnitState {
@@ -114,6 +175,7 @@ fn shipped_unit_frames_drive_end_to_end() {
             max_power: 0,
             dead: false,
             reaction: 4, // neutral
+            is_connected: true,
             ..UnitState::default()
         }),
     );
@@ -122,8 +184,10 @@ fn shipped_unit_frames_drive_end_to_end() {
     let ok: bool = s
         .eval(
             r#"
+            local _, pmax = TargetFrameManaBar:GetMinMaxValues()
             return TargetFrame:IsVisible()
-               and not TargetFrameManaBar:IsVisible()
+               and TargetFrameManaBar:GetValue() == 0 and pmax == 0
+               and TargetFrameManaBar.TextString == nil -- the reference declares no text region
                and TargetName:GetText() == "Young Wolf"
                and TargetLevelText:GetText() == "3"
                and not TargetDeadText:IsShown() -- living target: no dead word
@@ -132,7 +196,7 @@ fn shipped_unit_frames_drive_end_to_end() {
         .unwrap();
     assert!(
         ok,
-        "target frame painted; powerless unit hides its power bar"
+        "target frame painted; a powerless unit's power bar runs empty over an empty track"
     );
     // The select sound rides the frame's OnShow (ref TargetFrame_OnShow): a neutral (4) wolf is
     // neither UnitIsEnemy (≤2) nor UnitIsFriend (≥5) → the neutral kit.
@@ -341,20 +405,9 @@ fn unit_combat_drives_the_player_hit_indicator() {
 fn left_clicking_the_player_frame_targets_self() {
     let mut s = UiScript::new().unwrap();
     s.set_screen_size(1024.0, 768.0);
-    // The SELF-menu strings the popup rows bake at UnitPopup.xml load (no GlobalStrings in a
-    // bare engine — production reads the real file).
-    s.run(
-        r#"
-        LOOT_METHOD = "Loot Method"
-        LOOT_THRESHOLD = "Loot Threshold"
-        LOOT_GROUP_LOOT = "Group Loot"
-        PARTY_LEAVE = "Leave Party"
-        RAID_TARGET_ICON = "Raid Target Icon"
-        CANCEL = "Cancel"
-        ITEM_QUALITY2_DESC = "Uncommon"
-    "#,
-    )
-    .unwrap();
+    // The SELF-menu strings the popup rows bake at UnitPopup.xml load arrive with
+    // `load_unit_frames`' `GlobalStrings.lua`; they used to be hand-set here, and one of the
+    // hand-set values was wrong (see the row assertion below).
     load_unit_frames(&s);
 
     // The player must exist for the frame to be shown and mouse-hittable.
@@ -427,10 +480,14 @@ fn left_clicking_the_player_frame_targets_self() {
         6,
         "title + Loot Method + Loot Threshold + Leave Party + Raid Target Icon + Cancel"
     );
+    // `PARTY_LEAVE`, verbatim. The reference's own GlobalStrings.lua l.2991 is
+    // `PARTY_LEAVE = "Leave party"` — lower-case "party". The hand-set fixture this test used to
+    // open with title-cased it, so the row read back the fixture's own typo rather than the
+    // client's string; naming the real file is what exposed it.
     assert_eq!(
         s.eval::<String>("return DropDownList1Button4:GetText()")
             .unwrap(),
-        "Leave Party"
+        "Leave party"
     );
     // The nested rows carry the expand arrow (the level-2 gate for a leader).
     assert!(
@@ -467,21 +524,9 @@ fn left_clicking_the_player_frame_targets_self() {
 fn raid_mark_clicks_through_the_nested_level() {
     let mut s = UiScript::new().unwrap();
     s.set_screen_size(1024.0, 768.0);
-    s.run(
-        r#"
-        LOOT_METHOD = "Loot Method"
-        LOOT_THRESHOLD = "Loot Threshold"
-        LOOT_GROUP_LOOT = "Group Loot"
-        PARTY_LEAVE = "Leave Party"
-        RAID_TARGET_ICON = "Raid Target Icon"
-        CANCEL = "Cancel"
-        ITEM_QUALITY2_DESC = "Uncommon"
-        RAID_TARGET_1 = "Star"; RAID_TARGET_2 = "Circle"; RAID_TARGET_3 = "Diamond";
-        RAID_TARGET_4 = "Triangle"; RAID_TARGET_5 = "Moon"; RAID_TARGET_6 = "Square";
-        RAID_TARGET_7 = "Cross"; RAID_TARGET_8 = "Skull"; NONE = "None"
-    "#,
-    )
-    .unwrap();
+    // The menu strings arrive with `load_unit_frames`' own `GlobalStrings.lua`
+    // (`RAID_TARGET_ICON` l.3288, `RAID_TARGET_1..8` l.3280-3287, `NONE` l.2795), which is where
+    // production reads them; they used to be hand-set here.
     load_unit_frames(&s);
 
     s.set_unit(
@@ -551,6 +596,13 @@ fn raid_mark_clicks_through_the_nested_level() {
         .unwrap();
     s.mouse_button(sx as f32, sy as f32, "LeftButton", true);
     s.mouse_button(sx as f32, sy as f32, "LeftButton", false);
+    // RED while the `SetRaidTarget` engine binding is absent, and deliberately left that way.
+    // `UnitPopup.xml`'s row calls `SetRaidTargetIcon(menu.unit, mark)`; the definition of that
+    // used to be ours, and since the migration it is the reference's own — `TargetFrame.lua`
+    // l.486-492 — whose whole body is `SetRaidTarget(unit, 0 or index)`. `SetRaidTarget` is an
+    // engine verb this house does not have yet, so the click raises
+    // "attempt to call global 'SetRaidTarget' (a nil value)" and no intent is queued. 1203: it
+    // gets built, never stubbed.
     assert_eq!(
         s.take_party_requests(),
         vec![benilla_ui::script::PartyRequest::SetRaidTarget {
@@ -608,6 +660,7 @@ fn shipped_target_frame_runs_the_level_law() {
             exists: true,
             level: 3,
             is_player: true,
+            player_controlled: true,
             health: 50,
             max_health: 50,
             ..UnitState::default()
@@ -738,6 +791,7 @@ fn shipped_target_frame_runs_the_level_law() {
             exists: true,
             level: 30,
             is_player: true,
+            player_controlled: true,
             health: 50,
             max_health: 50,
             ..UnitState::default()
@@ -789,6 +843,7 @@ fn pvp_icon_follows_the_three_branch_law() {
         max_health: 50,
         level: 10,
         is_player: true,
+        player_controlled: true,
         faction_group: Some("Alliance".into()),
         pvp,
         is_pvp_ffa: ffa,
@@ -896,6 +951,7 @@ fn flagged_friendly_player_plate_is_green() {
         max_health: 50,
         level: 20,
         is_player: true,
+        player_controlled: true,
         reaction: 5,
         can_attack: false,
         faction_group: Some("Alliance".into()),
@@ -1075,10 +1131,16 @@ fn the_ring_art_paints_over_the_bars() {
             power_type: 0,
             power: 60,
             max_power: 100,
+            is_connected: true, // else the power bar takes the disconnect leg's grey max fill
             ..UnitState::default()
         }),
     );
-    s.fire_event("UNIT_HEALTH", vec![ScriptValue::Str("player".into())]);
+    // PLAYER_ENTERING_WORLD, not UNIT_HEALTH: the reference repaints the NAME only from
+    // `UnitFrame_Update` (ref UnitFrame.lua l.23-28) and on UNIT_NAME_UPDATE (l.31-34) — the
+    // health bar's own event touches its bar and nothing else. `PlayerFrame_OnEvent`'s
+    // PLAYER_ENTERING_WORLD arm (ref PlayerFrame.lua l.96-100) is the one that runs the full
+    // repaint, and the name quad is half of what this test measures.
+    s.fire_event("PLAYER_ENTERING_WORLD", vec![]);
     s.resolve();
     let quads = s.extract();
 
@@ -1131,16 +1193,28 @@ fn the_party_art_paints_over_the_bars() {
     // The loot test's prefix (`loot_tests.rs`): PartyFrame's inline <Script> reads
     // StaticPopupDialogs, which UiPanels.xml defines, and its per-member dropdown OnLoad walks the
     // whole popup kit.
+    // GlobalStrings first, for the same reason `load_unit_frames` names it — the stock unit-frame
+    // files resolve it at LOAD (`CombatFeedback.lua` l.7-17, `UnitFrame.lua` l.1-6).
+    load_xml(&s, "Interface\\FrameXML\\GlobalStrings.lua");
     load_xml(&s, "Fonts.xml");
     load_xml(&s, "MoneyFrame.xml");
     load_xml(&s, "UiPanels.xml");
     load_xml(&s, "GameTooltip.xml");
     load_xml(&s, "UIDropDownMenu.xml");
     load_xml(&s, "UnitPopup.xml");
-    // BENILLA_POWER_COLORS (the shared power-colour table) lives in UnitFrames.xml; the party
-    // frames' Update reads it. The player/target frames it also defines stay hidden here — no unit.
-    load_xml(&s, "UnitFrames.xml");
-    load_xml(&s, "PartyFrame.xml");
+    // The reference's own kit, in the manifest's order. `UIParent.xml` is not decoration here:
+    // `RaiseFrameLevel`/`LowerFrameLevel` live in it (ref UIParent.lua l.1890-1896) and stock
+    // `TargetofTargetTextureFrame`'s OnLoad calls one of them.
+    load_xml(&s, "UIParent.xml");
+    load_xml(&s, "Interface\\FrameXML\\TextStatusBar.lua");
+    load_xml(&s, "Interface\\FrameXML\\TextStatusBar.xml");
+    load_xml(&s, "Interface\\FrameXML\\BuffFrame.xml");
+    load_xml(&s, "Interface\\FrameXML\\UnitFrame.xml");
+    load_xml(&s, "Interface\\FrameXML\\CombatFeedback.xml");
+    load_xml(&s, "Interface\\FrameXML\\PlayerFrame.xml");
+    load_xml(&s, "Interface\\FrameXML\\PartyFrame.xml");
+    load_xml(&s, "Interface\\FrameXML\\TargetFrame.xml");
+    load_xml(&s, "Interface\\FrameXML\\PetFrame.xml");
 
     s.set_unit(
         "party1",
@@ -1153,9 +1227,27 @@ fn the_party_art_paints_over_the_bars() {
             power_type: 0,
             power: 60,
             max_power: 100,
+            is_connected: true,
             ..UnitState::default()
         }),
     );
+    // **The ROSTER, not the unit snapshot, is what shows a party row.** Stock
+    // `PartyMemberFrame_UpdateMember` gates on `GetPartyMember(id)` (ref PartyMemberFrame.lua
+    // l.41-57) — `UnitExists("party1")` is never consulted — and its else arm is `this:Hide()`.
+    // Our deleted `PartyFrame.xml` keyed the row off the unit token, so setting `party1` alone
+    // used to be enough; against the reference's file it paints nothing at all.
+    s.set_party(benilla_ui::script::PartyState {
+        members: vec![benilla_ui::script::PartyMemberInfo {
+            name: "Onepriest".into(),
+            guid: 0x0_0B12,
+        }],
+        leader_index: 0,
+        leader_guid: 0,
+        raid: Vec::new(),
+        loot_method: "group".into(),
+        master_looter: None,
+        loot_threshold: 2,
+    });
     s.fire_event("PARTY_MEMBERS_CHANGED", vec![]);
     s.resolve();
     let quads = s.extract();
@@ -1166,14 +1258,39 @@ fn the_party_art_paints_over_the_bars() {
         s.quad_owner_name(q.target)
             .is_some_and(|n| n.starts_with("PartyMemberFrame1"))
     };
-    let art = quads
+    // The ART cannot be scoped that way, and the reason is the reference's own declaration:
+    // `PartyMemberFrameTemplate` hangs `$parentTexture` two levels down inside a pair of
+    // **anonymous** `<Frame setAllPoints="true">` wrappers (ref PartyFrameTemplates.xml
+    // l.230-240). The region itself still resolves to `PartyMemberFrame1Texture` — `$parent`
+    // walks to the nearest named ancestor — but the frame that OWNS the quad has no name at all,
+    // so an owner-name filter can never see it. (Our deleted PartyFrame.xml gave that wrapper a
+    // name, `$parentTextureFrame`, which is why this used to work.) Scoped by geometry instead:
+    // rows 2-4 are hidden with no member, so exactly one UI-PartyFrame quad is drawn, and it is
+    // asserted to sit on member 1's rect.
+    let art_quads: Vec<_> = quads
         .iter()
-        .find(|q| {
-            mine(q)
-                && matches!(&q.content, QuadContent::Texture { path: Some(p), .. }
+        .filter(|q| {
+            matches!(&q.content, QuadContent::Texture { path: Some(p), .. }
                     if p.ends_with("UI-PartyFrame"))
         })
-        .expect("the party member frame art");
+        .collect();
+    assert_eq!(
+        art_quads.len(),
+        1,
+        "one member in the party, one row of art drawn"
+    );
+    let art = art_quads[0];
+    let row: Vec<f32> = s
+        .eval(
+            "return { PartyMemberFrame1:GetLeft(), PartyMemberFrame1:GetBottom(), \
+                      PartyMemberFrame1:GetRight(), PartyMemberFrame1:GetTop() }",
+        )
+        .unwrap();
+    let r = art.rect.expect("the art quad has a resolved rect");
+    assert!(
+        r.left >= row[0] - 1.0 && r.right <= row[2] + 1.0 && r.top <= row[3] + 3.0,
+        "the art quad sits on PartyMemberFrame1 (art {r:?}, row {row:?})"
+    );
     let fill = quads
         .iter()
         .filter(|q| {
@@ -1234,8 +1351,16 @@ fn a_feigning_target_paints_empty_bars_and_the_dead_text() {
     assert!(alive, "the control: a live hunter reads live");
 
     // He feigns. Only the flag moved on the wire — the snapshot turns it into these three.
+    //
+    // BOTH events, because the reference's bars are independent listeners: the health bar takes
+    // UNIT_HEALTH/UNIT_MAXHEALTH (ref UnitFrame.lua l.150-151) and the mana bar takes the ten
+    // UNIT_MANA/RAGE/FOCUS/… ones (l.189-199) — there is no shared "repaint the frame" event, so
+    // UNIT_HEALTH alone leaves the power bar showing the pre-feign number. Our deleted
+    // transcription drove both bars off one update, which is why this test used to fire one event.
+    // The server sends both when the dynflag lands.
     s.set_unit("target", hunter(0, 0, true));
     s.fire_event("UNIT_HEALTH", vec![ScriptValue::Str("target".into())]);
+    s.fire_event("UNIT_MANA", vec![ScriptValue::Str("target".into())]);
     let (hp, hmax, mana, mmax): (f64, f64, f64, f64) = (
         s.eval("return TargetFrameHealthBar:GetValue()").unwrap(),
         s.eval("local _, m = TargetFrameHealthBar:GetMinMaxValues() return m")
@@ -1270,6 +1395,7 @@ fn a_feigning_target_paints_empty_bars_and_the_dead_text() {
     // He stands back up: the flag clears, and nothing about the body needed restoring.
     s.set_unit("target", hunter(1200, 300, false));
     s.fire_event("UNIT_HEALTH", vec![ScriptValue::Str("target".into())]);
+    s.fire_event("UNIT_MANA", vec![ScriptValue::Str("target".into())]);
     let up: bool = s
         .eval(
             r#"
@@ -1444,10 +1570,21 @@ fn the_rest_badge_covers_the_level_number() {
 /// frames people actually watch (director report). Now the player's health and power bars carry
 /// "value / max", and the switch pins them.
 ///
-/// Which bars it pins is the REFERENCE's own split, transcribed rather than chosen: 1.12 sets
-/// `textLockable` on the player's two bars, the pet's two and the XP bar, and on nothing else — so
-/// the target frame's numerals are hover-only there and stay blank here. The power bar is whatever
-/// the unit runs on; a rage unit reads "45 / 80" the same as a mana one.
+/// Which bars it reaches is the REFERENCE's own split, and running the reference's own files made
+/// it narrower than 1146 believed. `textLockable` is set on the player's two bars, the pet's two
+/// and the XP bar and nothing else — but the TARGET frame goes further than "not lockable": it has
+/// **no text regions at all**. `TargetFrame.xml` l.486-487 hands `TargetFrameHealthBarText` /
+/// `TargetFrameManaBarText` to `UnitFrame_Initialize` and neither name is declared anywhere in
+/// FrameXML (only `PlayerFrame.xml` l.79/88 and `PetFrame.xml` l.87/96 declare theirs), so
+/// `SetTextStatusBarText` early-returns on the nil (ref TextStatusBar.lua l.7-10) and those bars
+/// never get a `TextString`. 1146 §3 *added* the two regions to our transcription so a hover could
+/// reveal them; they went with the file. What 1.12 actually gives you when you hover a target bar
+/// is the unit TOOLTIP (ref TextStatusBar.xml l.16-26), asserted below.
+///
+/// The power bar's numerals also carry the resource's LABEL again — "Rage 45 / 80" — because
+/// `UnitFrame_UpdateManaType` sets the prefix on every update (ref UnitFrame.lua l.129) and that
+/// call is inside the stock file. 1147 §1 cut ours on the director's look call; the stock file has
+/// no such cut.
 #[test]
 fn status_bar_text_paints_the_player_numerals_but_not_the_targets() {
     let mut s = UiScript::new().unwrap();
@@ -1465,6 +1602,10 @@ fn status_bar_text_paints_the_player_numerals_but_not_the_targets() {
         max_power: 80,
         dead: false,
         reaction: 4,
+        // Without this `UnitFrameManaBar_Update` takes its disconnect leg (ref UnitFrame.lua
+        // l.209-212) — the power bar pins to MAX and never reaches `UnitFrame_UpdateManaType`,
+        // so it would read "80 / 80" with no prefix.
+        is_connected: true,
         ..UnitState::default()
     };
     s.set_unit("player", Some(alive(72, 45, 1))); // power_type 1 = RAGE
@@ -1493,59 +1634,95 @@ fn status_bar_text_paints_the_player_numerals_but_not_the_targets() {
         shown(&s, "PlayerFrameHealthBarText"),
         "your own health numerals pin on"
     );
+    // Bare here, and only because this fixture stops short of the character window: the
+    // reference's "Health" prefix is set by `CharacterFrame_OnLoad` (ref CharacterFrame.lua l.55),
+    // not by the unit frames, and the manifest loads `Interface\FrameXML\CharacterFrame.xml` far
+    // below these. In a full run the player's health bar reads "Health 72 / 100".
     assert_eq!(
         text(&s, "PlayerFrameHealthBarText"),
         "72 / 100",
-        "bare numbers: the reference's \"Health\"/\"Rage\" labels were cut on the \
-         director's call (1147)"
+        "no prefix without the character window, which is what sets HEALTH"
     );
+    // The power bar's LABEL is back, and it is the unit frames' own:
+    // `UnitFrame_UpdateManaType` re-sets the prefix from `ManaBarColor[UnitPowerType(unit)].prefix`
+    // on every mana-bar update (ref UnitFrame.lua l.122-129), and
+    // `TextStatusBar_UpdateTextString` renders `prefix .. " " .. value .. " / " .. max`
+    // (ref TextStatusBar.lua l.42-46). 1147 §1 cut the three prefix calls out of OUR files on the
+    // director's look call; this one lives inside the stock file, so it came back with it.
+    assert_eq!(
+        s.eval::<String>("return PlayerFrameManaBar.prefix")
+            .unwrap(),
+        "Rage",
+        "the prefix follows the resource — this player runs on rage"
+    );
+    // The STRING, though, is still the one rendered before the switch existed. That is the
+    // reference's own ordering, not a gap: `TextStatusBar_OnEvent`'s CVAR_UPDATE arm only calls
+    // `TextString:Show()` (ref TextStatusBar.lua l.14-24) — it never re-renders — and the last
+    // render ran from `SetValue`'s OnValueChanged during PLAYER_ENTERING_WORLD, before
+    // `UnitFrame_UpdateManaType` had set the prefix (ref UnitFrame.lua l.208-215 sets the value
+    // first). Its own re-render is gated on `GetCVar("statusBarText") == "1"` (l.130-132), which
+    // was not yet true. So the label lands on the next repaint — asserted at the end of this test.
     assert_eq!(
         text(&s, "PlayerFrameManaBarText"),
         "45 / 80",
-        "the power bar shows the number alone, whatever resource it is"
+        "flipping the switch shows the string, it does not re-render it"
     );
 
-    // The target's stay dark with the switch ON: 1.12 never makes its bars textLockable, so the
-    // option does not reach them.
+    // The target's bars carry NO text region, so there is nothing for the switch to pin and
+    // nothing for a hover to reveal. Asserted on the globals themselves: the reference leaves both
+    // names undeclared (ref TargetFrame.xml l.486-487 passes them anyway).
     assert!(
-        !shown(&s, "TargetFrameHealthBarText"),
-        "the switch pins your own numbers, never the target's"
+        s.eval::<bool>(
+            "return TargetFrameHealthBarText == nil and TargetFrameManaBarText == nil \
+             and TargetFrameHealthBar.TextString == nil and TargetFrameManaBar.TextString == nil"
+        )
+        .unwrap(),
+        "the reference declares no numerals on the target frame, at any switch setting"
     );
 
-    // ...but the HOVER reveals them, which is how you read a target's health in 1.12 (1146).
-    s.run("BenillaUnitFrameBar_OnEnter(TargetFrameHealthBar)")
-        .unwrap();
-    assert!(shown(&s, "TargetFrameHealthBarText"));
-    assert_eq!(text(&s, "TargetFrameHealthBarText"), "50 / 100");
-    // `this` bound, as the engine binds it for a bar's own `<OnLeave>`: the stock
-    // `HideTextStatusBarText` reads `this.isZero` on one line where every other reads `bar`
-    // (TextStatusBar.lua:95 — the reference's own slip; a nil index only from bare Lua).
-    s.run(
-        "this = TargetFrameHealthBar BenillaUnitFrameBar_OnLeave(TargetFrameHealthBar) this = nil",
-    )
-    .unwrap();
+    // Hovering a target bar pops the unit TOOLTIP instead — the `elseif this:GetParent() ==
+    // TargetFrame` arm of the template's own OnEnter (ref TextStatusBar.xml l.16-26). Driven
+    // through the real pointer path, because that arm reads `this`.
+    hover(&mut s, "TargetFrameHealthBar");
     assert!(
-        !shown(&s, "TargetFrameHealthBarText"),
-        "and go away again — the lockShow refcount balances"
+        s.eval::<bool>(
+            "return GameTooltip:IsShown() and GameTooltip:IsOwned(TargetFrameHealthBar)"
+        )
+        .unwrap(),
+        "the target's bar hover is a tooltip, not numerals ({:?})",
+        s.errors()
+    );
+    assert!(
+        s.eval::<String>("return tostring(GameTooltipTextLeft1:GetText())")
+            .unwrap()
+            .contains("Somebody"),
+        "and it is the unit's own plate"
+    );
+    unhover(&mut s);
+    assert!(
+        s.eval::<bool>("return not GameTooltip:IsShown()").unwrap(),
+        "the template's OnLeave hides it (ref TextStatusBar.xml l.28-31)"
     );
 
-    // The same hover works with the switch OFF, which is the point of it on YOUR frame too: the
-    // numbers are there when you go looking, without living on the bar.
+    // The hover on YOUR bar with the switch OFF is the reveal that still exists: the numbers are
+    // there when you go looking, without living on the bar. `ShowTextStatusBarText` /
+    // `HideTextStatusBarText` and their `lockShow` refcount (ref TextStatusBar.lua l.77-102) are
+    // the mechanism, reached through the template's OnEnter/OnLeave.
     s.run("SetCVar(\"statusBarText\", \"0\", \"STATUS_BAR_TEXT\")")
         .unwrap();
     s.tick(0.0);
     assert!(!shown(&s, "PlayerFrameHealthBarText"));
-    s.run("BenillaUnitFrameBar_OnEnter(PlayerFrameHealthBar)")
-        .unwrap();
+    hover(&mut s, "PlayerFrameHealthBar");
     assert!(
         shown(&s, "PlayerFrameHealthBarText"),
-        "hover shows them even with the option off"
+        "hover shows them even with the option off ({:?})",
+        s.errors()
+    );
+    unhover(&mut s);
+    assert!(
+        !shown(&s, "PlayerFrameHealthBarText"),
+        "and go away again — the lockShow refcount balances"
     );
-    s.run(
-        "this = PlayerFrameHealthBar BenillaUnitFrameBar_OnLeave(PlayerFrameHealthBar) this = nil",
-    )
-    .unwrap();
-    assert!(!shown(&s, "PlayerFrameHealthBarText"));
     s.run("SetCVar(\"statusBarText\", \"1\", \"STATUS_BAR_TEXT\")")
         .unwrap();
     s.tick(0.0);
@@ -1555,10 +1732,11 @@ fn status_bar_text_paints_the_player_numerals_but_not_the_targets() {
     s.fire_event("UNIT_HEALTH", vec![ScriptValue::Str("player".into())]);
     assert_eq!(text(&s, "PlayerFrameHealthBarText"), "31 / 100");
 
-    // A power-type change repaints the same way (it used to re-LABEL the bar too — 1147 cut that).
+    // A power-type change repaints AND re-labels — `UnitFrame_UpdateManaType` runs off
+    // UNIT_DISPLAYPOWER (ref UnitFrame.lua l.36-40) and the prefix follows the new resource.
     s.set_unit("player", Some(alive(31, 60, 3)));
     s.fire_event("UNIT_DISPLAYPOWER", vec![ScriptValue::Str("player".into())]);
-    assert_eq!(text(&s, "PlayerFrameManaBarText"), "60 / 80");
+    assert_eq!(text(&s, "PlayerFrameManaBarText"), "Energy 60 / 80");
     assert!(s.errors().is_empty(), "script errors: {:?}", s.errors());
 }
 
diff --git a/crates/benilla-app/src/ui_script/unit_popup_tests.rs b/crates/benilla-app/src/ui_script/unit_popup_tests.rs
index 77b077f5..abfad1c9 100644
--- a/crates/benilla-app/src/ui_script/unit_popup_tests.rs
+++ b/crates/benilla-app/src/ui_script/unit_popup_tests.rs
@@ -26,7 +26,15 @@ fn load_popup_frames(s: &UiScript) {
         "UIDropDownMenu.xml",
         "UnitPopup.xml",
         "Interface\\FrameXML\\ItemRef.xml",
-        "UnitFrames.xml",
+        "Interface\\FrameXML\\TextStatusBar.lua",
+        "Interface\\FrameXML\\TextStatusBar.xml",
+        "Interface\\FrameXML\\BuffFrame.xml",
+        "Interface\\FrameXML\\UnitFrame.xml",
+        "Interface\\FrameXML\\CombatFeedback.xml",
+        "Interface\\FrameXML\\PlayerFrame.xml",
+        "Interface\\FrameXML\\PartyFrame.xml",
+        "Interface\\FrameXML\\TargetFrame.xml",
+        "Interface\\FrameXML\\PetFrame.xml",
         "ScrollTemplates.xml",
         "UIPanelTemplates.xml",
         "FriendsFrame.xml",
@@ -54,6 +62,17 @@ fn bake_strings(s: &UiScript) {
         FOLLOW = "Follow"
         CANCEL = "Cancel"
         RAID_TARGET_ICON = "Raid Target Icon"
+        -- The newbie tooltip the stock unit frame raises on a HOVER, which every test in this file
+        -- takes on its way to a right-click. `UnitFrame_OnEnter` (ref `UnitFrame.lua:58-65`) runs
+        -- the detailed-tip branch whenever `SHOW_NEWBIE_TIPS == "1"` — 1.12's own default
+        -- (`UIOptionsFrame.lua:100`), which our `GameTooltip.xml:46` sets at load — and for a
+        -- player-controlled target that is not us it calls
+        -- `GameTooltip_AddNewbieTip(PLAYER_OPTIONS_LABEL, 1, 1, 1, NEWBIE_TOOLTIP_PLAYEROPTIONS)`.
+        -- Both are nil in a bare harness, and `GameTooltip:SetText(nil)` raises. Verbatim from the
+        -- real `Interface\FrameXML\GlobalStrings.lua` off the 1.12.1 chain (l.3081 and l.2755).
+        -- Our deleted `UnitFrames.xml` never reached this arm; the stock file does.
+        PLAYER_OPTIONS_LABEL = "Player Options"
+        NEWBIE_TOOLTIP_PLAYEROPTIONS = "Right-click to bring up special commands for interacting with another player. You can inspect their equipment, issue a party invite, initiate a trade, or challenge a player to a duel. A group leader can promote or remove that player from the group."
     "#,
     )
     .unwrap();
@@ -146,6 +165,7 @@ fn solo_target_right_click_invites_a_player() {
             exists: true,
             name: Some("Me".into()),
             is_player: true,
+            player_controlled: true,
             ..UnitState::default()
         }),
     );
@@ -158,6 +178,7 @@ fn solo_target_right_click_invites_a_player() {
             health: 40,
             max_health: 40,
             is_player: true,
+            player_controlled: true,
             reaction: 5,
             ..UnitState::default()
         }),
@@ -246,6 +267,7 @@ fn solo_target_trade_click_queues_an_initiate() {
             exists: true,
             name: Some("Me".into()),
             is_player: true,
+            player_controlled: true,
             ..UnitState::default()
         }),
     );
@@ -257,6 +279,7 @@ fn solo_target_trade_click_queues_an_initiate() {
             health: 40,
             max_health: 40,
             is_player: true,
+            player_controlled: true,
             reaction: 5,
             ..UnitState::default()
         }),
@@ -314,6 +337,7 @@ fn solo_target_follow_click_queues_an_exact_by_name_follow() {
             exists: true,
             name: Some("Me".into()),
             is_player: true,
+            player_controlled: true,
             ..UnitState::default()
         }),
     );
@@ -325,6 +349,7 @@ fn solo_target_follow_click_queues_an_exact_by_name_follow() {
             health: 40,
             max_health: 40,
             is_player: true,
+            player_controlled: true,
             reaction: 5,
             ..UnitState::default()
         }),
@@ -383,6 +408,7 @@ fn solo_target_inspect_click_reaches_inspect_unit() {
             exists: true,
             name: Some("Me".into()),
             is_player: true,
+            player_controlled: true,
             ..UnitState::default()
         }),
     );
@@ -394,6 +420,7 @@ fn solo_target_inspect_click_reaches_inspect_unit() {
             health: 40,
             max_health: 40,
             is_player: true,
+            player_controlled: true,
             reaction: 5,
             ..UnitState::default()
         }),
@@ -442,7 +469,15 @@ fn load_pet_menu_frames(s: &UiScript) {
         "GameTooltip.xml",
         "UIDropDownMenu.xml",
         "UnitPopup.xml",
-        "UnitFrames.xml",
+        "Interface\\FrameXML\\TextStatusBar.lua",
+        "Interface\\FrameXML\\TextStatusBar.xml",
+        "Interface\\FrameXML\\BuffFrame.xml",
+        "Interface\\FrameXML\\UnitFrame.xml",
+        "Interface\\FrameXML\\CombatFeedback.xml",
+        "Interface\\FrameXML\\PlayerFrame.xml",
+        "Interface\\FrameXML\\PartyFrame.xml",
+        "Interface\\FrameXML\\TargetFrame.xml",
+        "Interface\\FrameXML\\PetFrame.xml",
         "Cooldown.xml",
         "ActionBar.xml",
         "PetActionBar.xml",
@@ -495,6 +530,7 @@ fn a_pet(s: &mut UiScript, name: &str) {
             max_health: 100,
             level: 60,
             is_player: true,
+            player_controlled: true,
             ..UnitState::default()
         }),
     );
@@ -521,9 +557,28 @@ fn a_pet(s: &mut UiScript, name: &str) {
 
 /// Open the pet menu through the real hit path, and return nothing — the assertions read
 /// `DropDownList1` afterwards.
+///
+/// **The click lands in the frame's own HIT RECT, not at its centre** — and on the reference's
+/// file those are two different places. Stock `PetFrame.xml:15-17` ships
+/// `<HitRectInsets><AbsInset left="7" right="66" top="6" bottom="7"/></HitRectInsets>` on a
+/// 128×53 button (`PetFrame.xml:4-7`), so the clickable
+/// band is the PORTRAIT half (x = left+7 … left+62) and the geometric centre (x = left+64) is two
+/// pixels outside it. Worse, the centre sits *inside* `PetFrameHealthBar` (`PetFrame.xml:125-135`:
+/// TOPLEFT 47,-22, 70×8), which is mouse-enabled by the `TextStatusBar` template's OnEnter
+/// (ref `TextStatusBar.xml:11-27`) and sits at `PetFrame.level + 1` — so under the hit law it
+/// takes the point and the click is consumed there. Unlike stock `PlayerFrame`, stock `PetFrame`
+/// ships **no** `<OnMouseUp>` forwarder on its bars, so that click is genuinely eaten in the real
+/// client too; a right-click on a pet's health bar opens nothing. Our deleted transcription had no
+/// hit-rect insets on the pet frame, which is the only reason `GetCenter()` ever worked here.
 fn right_click_the_pet_frame(s: &mut UiScript) {
     s.resolve();
-    let (cx, cy) = s.eval::<(f64, f64)>("return PetFrame:GetCenter()").unwrap();
+    let (cx, cy) = s
+        .eval::<(f64, f64)>(
+            "local il, ir, it, ib = PetFrame:GetHitRectInsets() \
+             return (PetFrame:GetLeft() + il + PetFrame:GetRight() - ir) / 2, \
+                    (PetFrame:GetBottom() + ib + PetFrame:GetTop() - it) / 2",
+        )
+        .unwrap();
     s.mouse_button(cx as f32, cy as f32, "RightButton", true);
     s.mouse_button(cx as f32, cy as f32, "RightButton", false);
     s.resolve();
@@ -759,6 +814,7 @@ fn an_idle_unit_popup_driver_parks_itself_off_the_tick() {
             exists: true,
             name: Some("Me".into()),
             is_player: true,
+            player_controlled: true,
             ..UnitState::default()
         }),
     );
@@ -772,6 +828,7 @@ fn an_idle_unit_popup_driver_parks_itself_off_the_tick() {
             health: 40,
             max_health: 40,
             is_player: true,
+            player_controlled: true,
             reaction: 5,
             ..UnitState::default()
         }),
@@ -849,6 +906,7 @@ fn an_idle_unit_popup_driver_parks_itself_off_the_tick() {
             health: 40,
             max_health: 40,
             is_player: true,
+            player_controlled: true,
             reaction: 5,
             is_connected: true,
             ..UnitState::default()
diff --git a/crates/benilla-app/src/ui_unit.rs b/crates/benilla-app/src/ui_unit.rs
index 198b81e6..a901d4fa 100644
--- a/crates/benilla-app/src/ui_unit.rs
+++ b/crates/benilla-app/src/ui_unit.rs
@@ -15,9 +15,12 @@
 //! query-cache seam): the feed resolves each token's guid, which asks the server once on a miss and
 //! fills in a later frame; the transition fires `UNIT_NAME_UPDATE` so frames repaint.
 //!
-//! The event surface is the Era set, fired per field on transitions: `UNIT_HEALTH`/`UNIT_MAXHEALTH`/
-//! `UNIT_LEVEL` (arg1 = token), `UNIT_POWER_UPDATE`/`UNIT_MAXPOWER` (token, power token e.g.
-//! `"MANA"`), `UNIT_DISPLAYPOWER` (power *type* changed), `UNIT_NAME_UPDATE`, plus
+//! The event surface is fired per field on transitions: `UNIT_HEALTH`/`UNIT_MAXHEALTH`/
+//! `UNIT_LEVEL` (arg1 = token), the **1.12** per-resource power pair `UNIT_MANA`/`UNIT_RAGE`/
+//! `UNIT_FOCUS`/`UNIT_ENERGY`/`UNIT_HAPPINESS` and their five `UNIT_MAX*` twins (arg1 = token; the
+//! resource is in the NAME, not an argument — decision 1819, which retired the Era
+//! `UNIT_POWER_UPDATE`/`UNIT_MAXPOWER` pair that no 1.12 frame listens for),
+//! `UNIT_DISPLAYPOWER` (power *type* changed), `UNIT_NAME_UPDATE`, plus
 //! `PLAYER_ENTERING_WORLD` once and `PLAYER_TARGET_CHANGED` on selection change. A token appearing
 //! counts as a transition of every present field (frames also pull on target change, so either path
 //! populates).
@@ -788,6 +791,11 @@ pub(crate) fn snapshot(
         // UNIT_FIELD_FLAGS (vmangos UnitDefines.h: 0x1000 / 0x04000000, VERIFIED).
         pvp: store.0.unit_flags() & 0x1000 != 0,
         skinnable: store.0.unit_flags() & 0x0400_0000 != 0,
+        // `UnitPlayerControlled` — the same word, bit 3 (`UNIT_FLAG_PVP_ATTACKABLE 0x8`, which is
+        // behaviourally "player-controlled"; `target::relations` already carved it for the duel
+        // leg of the selection ring). Wider than `is_player` above: a pet or a charmed creature
+        // sets it without being a player.
+        player_controlled: store.0.unit_flags() & 0x8 != 0,
         // `UnitAffectingCombat 0x517e10` — the SAME `UNIT_FIELD_FLAGS` word, bit 19
         // (`shr ecx,0x13; test cl,1`). One flag for every token: wow-re's whole-image census of
         // that idiom found the local-player readers reading this identical bit, so there is no
@@ -930,6 +938,14 @@ const PLAYER_FLAGS_PVP_DESIRED: u32 = 0x200;
 /// `IsResting 0x516ea0` tests (`shr 5; test 1` — wow-re rested-xp-bindings.md §3).
 const PLAYER_FLAGS_RESTING: u32 = 0x20;
 
+/// `PLAYER_FLAGS` bit 12 / bit 13 — the two **play-time** regimes an anti-addiction realm puts an
+/// account into, read by `PartialPlayTime` (`0x48eb70`) and `NoPlayTime` (`0x48ebe0`). Decision
+/// 1746 carved both, and settled that `0x1000` is PARTIAL_PLAY_TIME on 5875 rather than the
+/// pre-1.6.1 `CAN_SELF_RESURRECT` it had been read as. Stock `PlayerFrame_UpdatePlaytime` tests
+/// them at LOAD, so their absence is a raise on the first frame, not a cosmetic gap.
+const PLAYER_FLAGS_PARTIAL_PLAY_TIME: u32 = 0x1000;
+const PLAYER_FLAGS_NO_PLAY_TIME: u32 = 0x2000;
+
 /// The PvP-preference announcement rule (decision 0652): `(toast, verbose)` on a real change of the
 /// bit, `None` otherwise.
 ///
@@ -1027,7 +1043,6 @@ pub(crate) fn fire_transitions(
     cur: &UnitState,
 ) {
     let tok = || ScriptValue::Str(token.to_string());
-    let ptok = || ScriptValue::Str(power_token(cur.power_type).to_string());
     let changed = |f: fn(&UnitState) -> u64| prev.is_none_or(|p| f(p) != f(cur));
 
     if changed(|u| u64::from(u.health)) {
@@ -1042,11 +1057,28 @@ pub(crate) fn fire_transitions(
     if changed(|u| u64::from(u.power_type)) {
         script.fire_event("UNIT_DISPLAYPOWER", vec![tok()]);
     }
+    // The POWER pair is named per resource in 1.12, not once with the token as arg2: the reference's
+    // `UnitFrameManaBar_Initialize` registers `UNIT_MANA`/`UNIT_RAGE`/`UNIT_FOCUS`/`UNIT_ENERGY`/
+    // `UNIT_HAPPINESS` and the five `UNIT_MAX*` twins (`UnitFrame.lua:190-199`), and nothing in
+    // 1.12 FrameXML has ever heard of `UNIT_POWER_UPDATE`. `power_token` already yields exactly the
+    // suffix, so the name is the token. Health is unaffected — `UNIT_HEALTH`/`UNIT_MAXHEALTH` are
+    // spelled the same in both eras — and so is `UNIT_DISPLAYPOWER` above.
+    //
+    // This was live breakage, not tidiness: while we fired only the Era names, the stock unit frames
+    // registered only the 1.12 ones, so a mana/rage/energy bar never moved except when something
+    // else happened to call `UnitFrame_Update` (a target change, a pet summon, a frame show).
+    // Decision 1819.
     if changed(|u| u64::from(u.power)) {
-        script.fire_event("UNIT_POWER_UPDATE", vec![tok(), ptok()]);
+        script.fire_event(
+            &format!("UNIT_{}", power_token(cur.power_type)),
+            vec![tok()],
+        );
     }
     if changed(|u| u64::from(u.max_power)) {
-        script.fire_event("UNIT_MAXPOWER", vec![tok(), ptok()]);
+        script.fire_event(
+            &format!("UNIT_MAX{}", power_token(cur.power_type)),
+            vec![tok()],
+        );
     }
     if prev.is_none_or(|p| p.name != cur.name) {
         script.fire_event("UNIT_NAME_UPDATE", vec![tok()]);
@@ -1119,10 +1151,26 @@ fn feed_units(
     // The NPC the player is interacting with, for the `"npc"` token below. `Option` for the same
     // reason `index` and `factions` are: a UI-only harness runs this feed with no session plugin.
     interact: Option<Res<crate::ui_session::InteractNpc>>,
+    // The account's rested billing minutes ride the world-enter message, which is the only moment
+    // they ever arrive (decision 1820): the value comes off `SMSG_AUTH_RESPONSE` and the reference
+    // parks it in a process-lifetime global. `MessageReader` rather than a resource because it is
+    // an EDGE, and it is read here rather than in a system of its own because this feed already
+    // holds the script.
+    // `Option` for the same reason `index`, `factions` and `interact` above are: the message is
+    // registered by `NetPlugin`, and a UI-only harness runs this feed with no net stack at all —
+    // a bare reader turns that into a system-validation panic.
+    entered_world: Option<MessageReader<crate::net::EnteredWorldMessage>>,
 ) {
     let Some(mut script) = script else {
         return;
     };
+    // Ahead of the gate below, which is about descriptor deltas: this is a login edge and has no
+    // snapshot to diff.
+    if let Some(entered) =
+        entered_world.and_then(|mut r| r.read().last().map(|m| m.billing_time_rested))
+    {
+        script.set_billing_time_rested(entered);
+    }
     let chr = classes.as_deref().map(|t| &t.0);
     // One reborrow so the memo (`feed.vm`) and `feed.warned_sideless` can be borrowed as the
     // disjoint fields they are — through the `ResMut` deref they would alias.
@@ -1449,6 +1497,13 @@ fn feed_units(
             let prev = memo.last_rest;
             memo.last_rest = Some(rest);
             script.set_rest_state(rest.0, rest.1, rest.2 & PLAYER_FLAGS_RESTING != 0);
+            // The same descriptor word carries the two play-time bits, and they ride the same
+            // memo: `0x5ee990` fires PLAYER_FLAGS_CHANGED on ANY PLAYER_FLAGS delta without
+            // testing which bit moved, so one snapshot is the faithful granularity for all three.
+            script.set_play_time(
+                rest.2 & PLAYER_FLAGS_PARTIAL_PLAY_TIME != 0,
+                rest.2 & PLAYER_FLAGS_NO_PLAY_TIME != 0,
+            );
             if prev.map(|p| (p.0, p.1)) != Some((rest.0, rest.1)) {
                 script.fire_event("UPDATE_EXHAUSTION", vec![]);
             }
diff --git a/crates/benilla-protocol/src/events.rs b/crates/benilla-protocol/src/events.rs
index 3ac36862..3d5a9e5c 100644
--- a/crates/benilla-protocol/src/events.rs
+++ b/crates/benilla-protocol/src/events.rs
@@ -195,7 +195,15 @@ pub enum SessionEvent {
     CharActionResult { action: CharAction, code: u8 },
     /// We are in the world: `self_guid` is our player, `name` its character name. The IO thread emits
     /// this first, before any object updates.
-    Connected { self_guid: u64, name: String },
+    Connected {
+        self_guid: u64,
+        name: String,
+        /// The account's accumulated **rested billing minutes**, from the `SMSG_AUTH_RESPONSE`
+        /// that admitted this session — what `GetBillingTimeRested()` reports (decision 1820).
+        /// Rides the connect event because that is the only moment it ever arrives: the reference
+        /// keeps it in a process-lifetime global written once by the auth parser.
+        billing_time_rested: u32,
+    },
     /// The server confirmed our logout (`SMSG_LOGOUT_COMPLETE`) — we are back at character select.
     /// The IO thread cycles the connection immediately; a fresh [`Self::CharacterList`] follows.
     LoggedOut,
diff --git a/crates/benilla-protocol/src/messages/packet.rs b/crates/benilla-protocol/src/messages/packet.rs
index 30894200..436a9260 100644
--- a/crates/benilla-protocol/src/messages/packet.rs
+++ b/crates/benilla-protocol/src/messages/packet.rs
@@ -85,6 +85,15 @@ pub enum ServerPacket {
         /// Our place in the login queue, when `result` is [`super::AUTH_WAIT_QUEUE`] — `None` for
         /// every other result, and also for a queue packet whose body was too short to carry one.
         queue_position: Option<u32>,
+        /// The account's accumulated **rested billing minutes**, the third field of the billing
+        /// group — what `GetBillingTimeRested()` reports (decision 1820). `None` when the body was
+        /// too short to carry the group, which is the same length branch `queue_position` takes.
+        ///
+        /// The unit is the server's convention, not the engine's: the client applies no conversion
+        /// at any point (the binding `0x48ec50` does a bare unsigned u32→double, and the parser
+        /// `0x418eb0` a bare `mov`). Minutes is what the reference's own FrameXML assumes —
+        /// `PlayerFrame.lua:246` divides by 60 to get hours against `REQUIRED_REST_HOURS = 5`.
+        billing_time_rested: Option<u32>,
     },
     CharEnum {
         characters: Vec<Character>,
diff --git a/crates/benilla-protocol/src/messages/parse.rs b/crates/benilla-protocol/src/messages/parse.rs
index 78c51c7d..de05b32b 100644
--- a/crates/benilla-protocol/src/messages/parse.rs
+++ b/crates/benilla-protocol/src/messages/parse.rs
@@ -191,14 +191,21 @@ pub fn parse_server(opcode: u16, body: &[u8]) -> io::Result<ServerPacket> {
             // position as current is a bug we decline to reproduce.
             let result = read_u8(&mut r)?;
             let queued = result == super::AUTH_WAIT_QUEUE;
+            let mut billing_time_rested = None;
             if (result == super::AUTH_OK || queued) && r.len() >= 5 {
                 let _billing_time_remaining = read_u32_le(&mut r)?;
                 let _billing_plan_flags = read_u8(&mut r)?;
-                let _billing_time_rested = read_u32_le(&mut r)?;
+                // Kept rather than dropped since 1820: this is the only place the value ever
+                // arrives, and `GetBillingTimeRested()` is a plain read of it. The client parks it
+                // in a process-lifetime global (`[ClientServices+0x1af8]`, sole writer `0x5b421a`);
+                // ours rides the session, which has the same lifetime and cannot go stale across a
+                // reconnect the way that global does.
+                billing_time_rested = Some(read_u32_le(&mut r)?);
             }
             ServerPacket::AuthResponse {
                 result,
                 queue_position: queued.then(|| read_u32_le(&mut r).ok()).flatten(),
+                billing_time_rested,
             }
         }
         opcode::SMSG_CHAR_ENUM => {
diff --git a/crates/benilla-protocol/src/world/session.rs b/crates/benilla-protocol/src/world/session.rs
index 9792fb38..212ff2ca 100644
--- a/crates/benilla-protocol/src/world/session.rs
+++ b/crates/benilla-protocol/src/world/session.rs
@@ -90,6 +90,10 @@ pub struct WorldSession {
     /// vmangos drops any chat whose language the character doesn't know (dot-commands included) —
     /// hardcoded Common silently ate every Horde character's chat and commands once.
     chat_language: u32,
+    /// The rested billing minutes the admitting `SMSG_AUTH_RESPONSE` carried, or `0` when its body
+    /// was too short for the billing group. Read by [`Self::billing_time_rested`]; see decision
+    /// 1820 for why `0` rather than the client's own uninitialised-global behaviour.
+    billing_time_rested: u32,
 }
 
 impl WorldSession {
@@ -178,6 +182,7 @@ impl WorldSession {
             crypto,
             roster_races: Default::default(),
             chat_language: messages::LANGUAGE_COMMON,
+            billing_time_rested: 0,
         };
 
         // 4. Wait for SMSG_AUTH_RESPONSE. Usually the first encrypted packet, but not always first
@@ -191,7 +196,17 @@ impl WorldSession {
         // honest message at the login screen.
         loop {
             match session.recv()? {
-                ServerPacket::AuthResponse { result, .. } if result == messages::AUTH_OK => break,
+                ServerPacket::AuthResponse {
+                    result,
+                    billing_time_rested,
+                    ..
+                } if result == messages::AUTH_OK => {
+                    // The admitting packet is the only one that counts: a queue packet carries the
+                    // group too, but the client re-reads it on every AUTH_RESPONSE and the last one
+                    // wins, which is this one.
+                    session.billing_time_rested = billing_time_rested.unwrap_or(0);
+                    break;
+                }
                 // **Queued, not refused** — the realm is full and we keep our place in line. Report
                 // the position and go back to reading; the server re-sends as we move up and ends
                 // the wait with an `AUTH_OK`. Treating this as an ending (which it was until now)
@@ -199,6 +214,7 @@ impl WorldSession {
                 ServerPacket::AuthResponse {
                     result,
                     queue_position,
+                    ..
                 } if result == messages::AUTH_WAIT_QUEUE => {
                     if !queued {
                         queued = true;
@@ -230,6 +246,17 @@ impl WorldSession {
         Ok(session)
     }
 
+    /// The account's accumulated **rested billing minutes**, from the `SMSG_AUTH_RESPONSE` that
+    /// admitted this session — what `GetBillingTimeRested()` reports (decision 1820).
+    ///
+    /// Against vmangos this is always `0`: the server hardcodes `uint32(0)` for the field
+    /// (`World.cpp:331`, and `:380` for the queue packet), guarded on a build newer than 1.7.1,
+    /// which 1.12 is. It is read from the wire rather than assumed so that a server which does
+    /// populate it is reported honestly.
+    pub fn billing_time_rested(&self) -> u32 {
+        self.billing_time_rested
+    }
+
     /// Set a read timeout on the underlying socket (e.g. so a debug read-loop can stop when the
     /// world goes quiet). `None` clears it (blocking reads).
     pub fn set_read_timeout(&self, timeout: Option<std::time::Duration>) -> Result<()> {
diff --git a/crates/benilla-ui/src/script/aura/mod.rs b/crates/benilla-ui/src/script/aura/mod.rs
index a4e7ad3a..341c79f0 100644
--- a/crates/benilla-ui/src/script/aura/mod.rs
+++ b/crates/benilla-ui/src/script/aura/mod.rs
@@ -200,6 +200,38 @@ pub(super) fn cancel_authorized(a: &AuraState) -> bool {
 /// nameplateShowPersonal, spellId`. The three we cannot know on this wire (`source`, `isStealable`,
 /// `nameplateShowPersonal`) return nil — an addon that reads them sees "unknown", which is honest,
 /// rather than a fabricated value.
+/// The **1.12** return tuple, which is a different shape and not a prefix of the Era one: the first
+/// value is the TEXTURE, not the name. `UnitBuff` returns `(texture, applications)` (`0x519500`) and
+/// `UnitDebuff` returns `(texture, applications, dispelType)` (`0x5198f0`) — both `verified` in
+/// wow-re's ledger, and both are what the reference's own FrameXML reads
+/// (`TargetFrame.lua:287-290` binds `debuff, debuffStack, debuffType` and then
+/// `SetTexture(debuff)`). Decision 1818, which also records why the Era shape was serving nobody.
+fn returns_1121(lua: &Lua, a: &AuraState, with_dispel_type: bool) -> mlua::Result<MultiValue> {
+    let icon = match &a.icon {
+        Some(t) => Value::String(lua.create_string(t)?),
+        None => Value::Nil,
+    };
+    let mut out = vec![icon, Value::Integer(i64::from(a.count))];
+    if with_dispel_type {
+        out.push(match &a.debuff_type {
+            Some(t) => Value::String(lua.create_string(t)?),
+            None => Value::Nil,
+        });
+    }
+    Ok(MultiValue::from_vec(out))
+}
+
+/// Which return shape a getter wants — the two are not compatible, see [`returns_1121`].
+#[derive(Clone, Copy)]
+enum Shape {
+    /// `UnitAura`'s ten values. Era-only: the name does not exist in 1.12 FrameXML at all.
+    Era,
+    /// `UnitBuff`'s two.
+    Buff,
+    /// `UnitDebuff`'s three.
+    Debuff,
+}
+
 fn returns(lua: &Lua, a: &AuraState) -> mlua::Result<MultiValue> {
     let s = |v: &Option<String>| -> mlua::Result<Value> {
         Ok(match v {
@@ -229,6 +261,7 @@ fn nth_aura(
     token: &Option<String>,
     index: i64,
     filter: &Filter,
+    shape: Shape,
 ) -> mlua::Result<MultiValue> {
     if index < 1 {
         return Ok(MultiValue::new());
@@ -246,7 +279,11 @@ fn nth_aura(
             })
     };
     match hit {
-        Some(a) => returns(lua, &a),
+        Some(a) => match shape {
+            Shape::Era => returns(lua, &a),
+            Shape::Buff => returns_1121(lua, &a, false),
+            Shape::Debuff => returns_1121(lua, &a, true),
+        },
         None => Ok(MultiValue::new()),
     }
 }
@@ -285,39 +322,62 @@ impl super::UiScript {
 pub(super) fn install(lua: &Lua) -> mlua::Result<()> {
     let g = lua.globals();
 
-    // UnitAura(unit, index [, filter]) — filter defaults to HELPFUL, like the live API.
+    // UnitAura(unit, index [, filter]) — filter defaults to HELPFUL, like the live API. This one
+    // keeps the Era tuple: it is not a 1.12 verb at all (zero occurrences in the reference's
+    // FrameXML) and has zero call sites in the 110-addon corpus, so it costs nothing and stays the
+    // Era-compat surface 0068 asked for.
     g.set(
         "UnitAura",
         lua.create_function(
             |lua, (token, index, filter): (Option<String>, i64, Option<String>)| {
-                nth_aura(lua, &token, index, &Filter::parse(filter.as_deref()))
+                nth_aura(
+                    lua,
+                    &token,
+                    index,
+                    &Filter::parse(filter.as_deref()),
+                    Shape::Era,
+                )
             },
         )?,
     )?;
 
-    // UnitBuff/UnitDebuff(unit, index [, filter]) — the live API pins the sign and folds any extra
-    // filter tokens (CANCELABLE, …) in alongside it.
+    // UnitBuff(unit, index [, raidFilter]) / UnitDebuff(unit, index [, raidFilter]) — the 1.12
+    // signature and the 1.12 RETURN SHAPE (decision 1818). The sign is fixed by the verb, not by a
+    // filter word: `0x519500` reads aura slots 0..31 and `0x5198f0` reads 32..47.
+    //
+    // **The third argument is a `raidFilter` flag, not Era's filter string.** Non-zero enables ONE
+    // extra per-slot predicate — castable-by-me for buffs (`0x4b3870`), dispellable-by-me for
+    // debuffs (`0x4b3920`). We accept it and DO NOT apply it, because [`AuraState`] holds neither
+    // fact and neither is derivable from the aura feed: castable-by-me needs the player's spellbook,
+    // dispellable-by-me needs a class→dispel-type table joined to `debuff_type`. Inventing an answer
+    // is the guess 1203 exists to prevent, so the flag is parked here in the open. Visible
+    // consequence, so nobody has to rediscover it: the pet frame's buff row and the
+    // dispellable-debuff rows show everything rather than only what the player can cast or dispel.
     g.set(
         "UnitBuff",
         lua.create_function(
-            |lua, (token, index, filter): (Option<String>, i64, Option<String>)| {
-                let spec = match filter {
-                    Some(f) => format!("HELPFUL|{f}"),
-                    None => "HELPFUL".to_string(),
-                };
-                nth_aura(lua, &token, index, &Filter::parse(Some(&spec)))
+            |lua, (token, index, _raid_filter): (Option<String>, i64, Option<Value>)| {
+                nth_aura(
+                    lua,
+                    &token,
+                    index,
+                    &Filter::parse(Some("HELPFUL")),
+                    Shape::Buff,
+                )
             },
         )?,
     )?;
     g.set(
         "UnitDebuff",
         lua.create_function(
-            |lua, (token, index, filter): (Option<String>, i64, Option<String>)| {
-                let spec = match filter {
-                    Some(f) => format!("HARMFUL|{f}"),
-                    None => "HARMFUL".to_string(),
-                };
-                nth_aura(lua, &token, index, &Filter::parse(Some(&spec)))
+            |lua, (token, index, _raid_filter): (Option<String>, i64, Option<Value>)| {
+                nth_aura(
+                    lua,
+                    &token,
+                    index,
+                    &Filter::parse(Some("HARMFUL")),
+                    Shape::Debuff,
+                )
             },
         )?,
     )?;
@@ -429,16 +489,18 @@ mod tests {
                 .unwrap(),
             "Battle Stance"
         );
+        // `UnitBuff`/`UnitDebuff` enumerate the same list, but their first return is the ICON, not
+        // the name (1.12's shape — decision 1818), so they are addressed by it here.
         assert_eq!(
             s.eval::<String>(r#"return (UnitBuff("player", 2))"#)
                 .unwrap(),
-            "Mark of the Wild"
+            "Interface\\Icons\\Spell_1126"
         );
         // The debuff is index 1 of its own filter, not index 3.
         assert_eq!(
             s.eval::<String>(r#"return (UnitDebuff("player", 1))"#)
                 .unwrap(),
-            "Shadow Word: Pain"
+            "Interface\\Icons\\Spell_589"
         );
         // Past the end → nil, the loop terminator.
         assert!(s
@@ -512,7 +574,7 @@ mod tests {
 
         let (name, icon, count, dtype, dur, expiry, spell) = s
             .eval::<(String, String, i64, String, f64, f64, i64)>(
-                r#"local n, i, c, d, du, e, src, st, np, sid = UnitDebuff("target", 1)
+                r#"local n, i, c, d, du, e, src, st, np, sid = UnitAura("target", 1, "HARMFUL")
                    assert(src == nil and st == nil and np == nil, "unknowable fields must be nil")
                    return n, i, c, d, du, e, sid"#,
             )
@@ -524,6 +586,62 @@ mod tests {
         assert_eq!(spell, 589);
     }
 
+    /// The **1.12** shape, which is not a prefix of the Era one: `UnitBuff` → `(texture,
+    /// applications)`, `UnitDebuff` → `(texture, applications, dispelType)`, and the FIRST value is
+    /// the texture. Decision 1818; `0x519500`/`0x5198f0`, both `verified` in wow-re's ledger. The
+    /// reference's own FrameXML reads exactly this (`TargetFrame.lua:287-290`), and so does every
+    /// one of the 184 call sites in the addon corpus.
+    #[test]
+    fn unit_buff_and_unit_debuff_return_the_1121_tuple_not_the_era_one() {
+        let mut s = UiScript::new().unwrap();
+        let mut buff = aura(1126, "Mark of the Wild", true, true);
+        buff.count = 1;
+        let mut debuff = aura(589, "Shadow Word: Pain", false, false);
+        debuff.count = 3;
+        debuff.debuff_type = Some("Magic".into());
+        s.set_auras("target", Some(vec![buff, debuff]));
+
+        // UnitBuff returns exactly TWO values, texture first.
+        let (icon, count, third) = s
+            .eval::<(String, i64, Option<String>)>(
+                r#"local a, b, c = UnitBuff("target", 1) return a, b, c"#,
+            )
+            .unwrap();
+        assert_eq!(icon, "Interface\\Icons\\Spell_1126");
+        assert_eq!(count, 1);
+        assert_eq!(third, None, "UnitBuff returns two values, never a third");
+
+        // UnitDebuff returns THREE, the dispel type last.
+        let (icon, count, dispel, fourth) = s
+            .eval::<(String, i64, String, Option<String>)>(
+                r#"local a, b, c, d = UnitDebuff("target", 1) return a, b, c, d"#,
+            )
+            .unwrap();
+        assert_eq!(icon, "Interface\\Icons\\Spell_589");
+        assert_eq!((count, dispel.as_str()), (3, "Magic"));
+        assert_eq!(
+            fourth, None,
+            "UnitDebuff returns three values, never a fourth"
+        );
+
+        // The reference's own read, verbatim from TargetFrame.lua:287-297 — the comparison that
+        // raised `attempt to compare number with string` while we returned the Era tuple.
+        assert!(s
+            .eval::<bool>(
+                r#"local d, stack, dtype = UnitDebuff("target", 1)
+                   return stack > 1 and dtype == "Magic""#
+            )
+            .unwrap());
+
+        // The raidFilter argument is ACCEPTED and its predicate is not applied (1818): passing it
+        // must not error, and must not change the answer.
+        assert_eq!(
+            s.eval::<String>(r#"return (UnitDebuff("target", 1, 1))"#)
+                .unwrap(),
+            "Interface\\Icons\\Spell_589"
+        );
+    }
+
     #[test]
     fn cancel_unit_buff_queues_the_spell_id_and_refuses_a_non_cancelable_aura() {
         let mut s = UiScript::new().unwrap();
diff --git a/crates/benilla-ui/src/script/mod.rs b/crates/benilla-ui/src/script/mod.rs
index 12b5f3df..ebe6fb9a 100644
--- a/crates/benilla-ui/src/script/mod.rs
+++ b/crates/benilla-ui/src/script/mod.rs
@@ -412,15 +412,17 @@ pub const SCREEN: crate::layout::Handle = 0;
 ///
 /// **This list is FLAT; the reference's set is per widget type** (RF-0028's script-name→slot
 /// resolvers: base map `0x76a0d0` + the type's own additions — a `<Frame>` has no `OnClick`). That
-/// divergence is deliberate and measured: our own transcribed FrameXML relies on it in 9 places
-/// (`PlayerFrame`/`TargetFrame`/`PetFrame`/`PartyMemberFrame1-4` are mouse-enabled `<Frame>`s
-/// carrying `OnClick` — see the note at `assets/ui/UnitFrames.xml`'s `PlayerFrame_OnClick` — plus
-/// `ChatFrame1`/`ChatFrame2`), and the corpus in 21 more (20 `EditBox` + 1 `<Frame>`
+/// divergence is deliberate and measured, and the 1751 migration has been shrinking the debt it
+/// covers. Our own FrameXML used to rely on it in 9 places; seven of them were
+/// `PlayerFrame`/`TargetFrame`/`PetFrame`/`PartyMemberFrame1-4` declared as mouse-enabled
+/// `<Frame>`s carrying `OnClick` in our transcribed `UnitFrames.xml`, and that file is gone — the
+/// reference declares all seven as `<Button>`, which carries `OnClick` by type. What is left of
+/// ours is `ChatFrame1`/`ChatFrame2`, plus the corpus's 21 (20 `EditBox` + 1 `<Frame>`
 /// `OnEscapePressed`), all of which fire today ([`button::click_button`]'s "plain frames can carry
 /// one too" arm). Going per-type is the faithful shape and is what would give us `HasScript` (948
-/// corpus call sites across 91 addons), but it removes working behaviour from those 30 sites, so it
-/// is a change to make deliberately with FrameXML fixed first — not a side effect of widening this
-/// list.
+/// corpus call sites across 91 addons); it removes working behaviour from the 23 sites that remain,
+/// so it is still a change to make deliberately rather than as a side effect of widening this list
+/// — but the FrameXML half of "with FrameXML fixed first" is most of the way there now.
 const SCRIPT_KINDS: [&str; 35] = [
     "OnLoad",
     "OnEvent",
diff --git a/crates/benilla-ui/src/script/model.rs b/crates/benilla-ui/src/script/model.rs
index 6de1ad02..c25bb571 100644
--- a/crates/benilla-ui/src/script/model.rs
+++ b/crates/benilla-ui/src/script/model.rs
@@ -592,6 +592,26 @@ pub(crate) struct Model {
     /// [`UiScript::take_sounds`] drain — the outbound Lua→app intent seam ([`sound`]).
     pub(crate) sound_queue: Vec<SoundRequest>,
 
+    /// **The UI-load sound-suppression depth** — `[0xb05fa0]` in the reference, a counted scope
+    /// with exactly three references image-wide: `0x458f50` (`inc`), `0x458f60` (`dec`), and one
+    /// reader at `0x458046`, inside `PlaySoundByName 0x458030`. The whole-UI load `0x48fbf0`
+    /// brackets ITSELF in it — `0x48fbfa` on entry, `0x49016d` on exit, spanning the TOC walk,
+    /// `Bindings.xml` and the AddOns — and both of its callers, login (`0x48f681`) and `/reloadui`
+    /// (`0x495669`), therefore load silently.
+    ///
+    /// The reader bails at `0x45804d` **before** the `MasterSoundEffects` CVar and the kit-hash
+    /// lookup, so a suppressed call is **dropped**: not muted, not queued, no Lua error, and the
+    /// binding still answers its usual `(willPlay, handle)`. Scoped to the NAME-keyed entry only —
+    /// id-keyed `PlaySound(kitId)` (`0x457fb0`/`0x457ff0`), `PlaySoundFile`, `PlayMusic` and
+    /// `StopMusic` all run normally inside the scope.
+    ///
+    /// This is what makes stock `TargetFrame_OnHide`'s `PlaySound("INTERFACESOUND_LOSTTARGETUNIT")`
+    /// inaudible at every login: the frame really is shown when its `OnLoad` hides it, the OnHide
+    /// really does fire, the call really is made — and the engine throws it away. Decision 1033's
+    /// "no sound during the load" is the client's own law, enforced here rather than by hoping no
+    /// handler rings.
+    pub(crate) sound_suppression: u32,
+
     /// The CVar table (decision 0954, [`super::cvars`]): lowercase name → slot. Host-registered
     /// only; Lua reads/writes through `GetCVar`/`SetCVar`/`GetCVarDefault`.
     pub(crate) cvars: HashMap<String, super::cvars::CvarSlot>,
@@ -1235,6 +1255,23 @@ pub(crate) struct Model {
     pub(crate) rest_state: u8,
     pub(crate) rest_pool: u32,
     pub(crate) resting: bool,
+
+    /// `PLAYER_FLAGS` bit 12 — **PARTIAL_PLAY_TIME**, what `PartialPlayTime()` answers
+    /// (`0x48eb70`, `shr eax,0xc` / `and al,1`; decision 1746 §"`PLAYER_FLAGS` bit `0x1000` is
+    /// read after all"). The play-time regime a realm with an anti-addiction policy puts an
+    /// account into; on a western realm it never sets.
+    pub(crate) partial_play_time: bool,
+
+    /// `PLAYER_FLAGS` bit 13 — what `NoPlayTime()` answers (`0x48ebe0`, the neighbour of the
+    /// above and the harsher half of the same regime).
+    pub(crate) no_play_time: bool,
+
+    /// The account's accumulated **rested billing minutes**, from `SMSG_AUTH_RESPONSE` — what
+    /// `GetBillingTimeRested()` returns (decision 1820, binding `0x48ec50`). Minutes is the
+    /// server's convention and the engine converts nothing; stock `PlayerFrame.lua:246` divides by
+    /// 60 for hours. Reached only from inside the two play-time bits above, so with those clear
+    /// nothing in stock FrameXML ever reads it.
+    pub(crate) billing_time_rested: u32,
     /// Is a cinematic playing? What `InCinematic()` reports, pushed by the cinematic plugin.
     ///
     /// Read by more than the letterbox: `StaticPopup_Show` refuses any dialog whose entry lacks
@@ -1600,6 +1637,7 @@ impl Model {
             action_bar_toggles: None,
             action_bar_toggle_sends: Vec::new(),
             sound_queue: Vec::new(),
+            sound_suppression: 0,
             cvars: HashMap::new(),
             cvars_saved_base: HashMap::new(),
             cvar_changes: Vec::new(),
@@ -1804,6 +1842,9 @@ impl Model {
             rest_state: 2,
             rest_pool: 0,
             resting: false,
+            partial_play_time: false,
+            no_play_time: false,
+            billing_time_rested: 0,
             in_cinematic: false,
             exhaustion: [
                 (1, ("Rested".to_string(), 2.0)),
diff --git a/crates/benilla-ui/src/script/party.rs b/crates/benilla-ui/src/script/party.rs
index 7250c163..181e657f 100644
--- a/crates/benilla-ui/src/script/party.rs
+++ b/crates/benilla-ui/src/script/party.rs
@@ -205,7 +205,7 @@ pub enum PartyRequest {
     },
     /// `SetLootThreshold(n)` — the new quality floor.
     LootThreshold(u32),
-    /// `SetRaidTargetIcon(unit, index)` — mark (1..=8) or clear (0) the raid-target icon on a
+    /// `SetRaidTarget(unit, index)` — mark (1..=8) or clear (0) the raid-target icon on a
     /// unit, addressed by token; the app resolves the token to a guid for the
     /// `MSG_RAID_TARGET_UPDATE` send (decision 0434 §5's submenu, §6's board law).
     SetRaidTarget { unit: String, index: u8 },
@@ -561,8 +561,15 @@ pub(super) fn install(lua: &Lua) -> mlua::Result<()> {
             Ok(())
         })?,
     )?;
+    // SetRaidTarget(unit, index) — the ENGINE verb. `SetRaidTargetIcon` is NOT one: it is FrameXML,
+    // `function SetRaidTargetIcon(unit, index)` at `TargetFrame.lua:486`, a toggle wrapper that
+    // calls this with 0 when the unit already wears `index`. We had registered the wrapper's name on
+    // this body, which behaved correctly and so never showed — until 1751 put `TargetFrame.lua` on
+    // the chain and the wrapper started calling a `SetRaidTarget` that did not exist. Proof both
+    // ways: no `function SetRaidTarget(` anywhere in the reference's FrameXML, and both
+    // `TargetFrame.lua:488`/`:490` and `Bindings.xml:1160` call it bare.
     g.set(
-        "SetRaidTargetIcon",
+        "SetRaidTarget",
         lua.create_function(|lua, (unit, index): (String, u8)| {
             let mut model = lua.app_data_mut::<Model>().expect("model app_data");
             model
@@ -1157,8 +1164,8 @@ mod tests {
     #[test]
     fn set_raid_target_icon_queues_the_token_and_index() {
         let mut s = UiScript::new().unwrap();
-        s.run(r#"SetRaidTargetIcon("target", 8)"#).unwrap();
-        s.run(r#"SetRaidTargetIcon("party2", 0)"#).unwrap();
+        s.run(r#"SetRaidTarget("target", 8)"#).unwrap();
+        s.run(r#"SetRaidTarget("party2", 0)"#).unwrap();
         assert_eq!(
             s.take_party_requests(),
             vec![
diff --git a/crates/benilla-ui/src/script/sound.rs b/crates/benilla-ui/src/script/sound.rs
index 83a98627..a1a82112 100644
--- a/crates/benilla-ui/src/script/sound.rs
+++ b/crates/benilla-ui/src/script/sound.rs
@@ -85,7 +85,16 @@ pub(super) fn install(lua: &Lua) -> mlua::Result<()> {
                 ));
             };
             let mut model = lua.app_data_mut::<Model>().expect("model app_data");
-            model.sound_queue.push(req);
+            // `PlaySoundByName 0x458030`'s first act: read the UI-load suppression depth
+            // (`0x458046`) and bail at `0x45804d` if it is non-zero — BEFORE the
+            // `MasterSoundEffects` CVar and before the kit-hash lookup. So the call is dropped
+            // rather than muted or queued, and the binding still answers as if it had played.
+            // NAME-keyed only: the id-keyed entry (`0x457fb0`) has no such gate, which is why the
+            // arm above pushes unconditionally.
+            let suppressed = matches!(req, SoundRequest::KitName(_)) && model.sound_suppression > 0;
+            if !suppressed {
+                model.sound_queue.push(req);
+            }
             drop(model);
             // willPlay (queued), soundHandle (nil — module docs).
             Ok((true, Value::Nil))
diff --git a/crates/benilla-ui/src/script/unit/bindings.rs b/crates/benilla-ui/src/script/unit/bindings.rs
index a0c83764..3222229c 100644
--- a/crates/benilla-ui/src/script/unit/bindings.rs
+++ b/crates/benilla-ui/src/script/unit/bindings.rs
@@ -323,6 +323,42 @@ pub(in crate::script) fn install(lua: &Lua) -> mlua::Result<()> {
     // red/blue player legs, an NPC the reaction swatch. (The live gate is `UnitPlayerControlled`,
     // which also covers pets/charmed creatures; we resolve only the player half of it — the extra
     // reach needs a player-controlled flag we don't carry, and a player's own alt is the case here.)
+    // UnitIsCivilian(unit) → 1 if killing this unit would be a DISHONORABLE kill, else nil. This is
+    // `0x612550` itself handed to Lua — the same four-term predicate (`pvp` bit AND creature-query
+    // civilian flag AND hostile AND the kill would be grey) that the unit tooltip's green CIVILIAN
+    // line and `UnitPVPName`'s civilian arm already run through `is_civilian_kill`. That function's
+    // doc called itself "ONE home, two callers"; the stock target frame is the third, and it is the
+    // one that names the predicate — `TargetFrame_CheckDishonorableKill` (TargetFrame.lua:230) is
+    // its only FrameXML caller and the comment inside it reads "Is a dishonorable kill".
+    //
+    // Sharing the function is the point: a second copy would let the tooltip, the name and the
+    // target plate disagree about the same mob.
+    g.set(
+        "UnitIsCivilian",
+        lua.create_function(|lua, unit: Option<String>| {
+            let model = lua.app_data_ref::<Model>().expect("model app_data");
+            let player_level = model.player_req.level;
+            Ok(match unit.and_then(|u| model.unit(&u)) {
+                Some(u) if super::is_civilian_kill(u, player_level) => Value::Integer(1),
+                _ => Value::Nil,
+            })
+        })?,
+    )?;
+    // UnitPlayerControlled(unit) → 1 if a PLAYER is driving this unit, else nil. `UNIT_FIELD_FLAGS`
+    // bit 3 (`UNIT_FLAG_PVP_ATTACKABLE 0x8`), which is wider than `UnitIsPlayer` below: a player's
+    // pet and a charmed creature answer 1 here and nil there. Stock `UnitFrame_OnEnter`
+    // (UnitFrame.lua:58) is the caller that made this a blocker rather than a nicety — it gates the
+    // player-options newbie tip on it, so a missing binding raised on the first unit-frame hover.
+    g.set(
+        "UnitPlayerControlled",
+        lua.create_function(|lua, unit: Option<String>| {
+            let model = lua.app_data_ref::<Model>().expect("model app_data");
+            Ok(match unit.and_then(|u| model.unit(&u)) {
+                Some(u) if u.player_controlled => Value::Integer(1),
+                _ => Value::Nil,
+            })
+        })?,
+    )?;
     g.set(
         "UnitIsPlayer",
         lua.create_function(|lua, token: Option<String>| {
@@ -902,6 +938,54 @@ pub(in crate::script) fn install(lua: &Lua) -> mlua::Result<()> {
             })
         })?,
     )?;
+    // PartialPlayTime() / NoPlayTime() → 1/nil: the two anti-addiction play-time regimes, read
+    // straight off `PLAYER_FLAGS` — `0x48eb70` is `shr eax,0xc; and al,1` (bit 12) and `0x48ebe0`
+    // its bit-13 neighbour (decision 1746, which carved both while establishing that bit 0x1000 is
+    // PARTIAL_PLAY_TIME on 5875 rather than the pre-1.6.1 CAN_SELF_RESURRECT). Same Lua-vanilla
+    // predicate shape as `IsResting` above: the NUMBER 1 or nil, never a boolean. Stock
+    // `PlayerFrame_UpdatePlaytime` (PlayerFrame.lua:244) is the only FrameXML caller of either.
+    g.set(
+        "PartialPlayTime",
+        lua.create_function(|lua, ()| {
+            let model = lua.app_data_ref::<Model>().expect("model app_data");
+            Ok(if model.partial_play_time {
+                Value::Integer(1)
+            } else {
+                Value::Nil
+            })
+        })?,
+    )?;
+    g.set(
+        "NoPlayTime",
+        lua.create_function(|lua, ()| {
+            let model = lua.app_data_ref::<Model>().expect("model app_data");
+            Ok(if model.no_play_time {
+                Value::Integer(1)
+            } else {
+                Value::Nil
+            })
+        })?,
+    )?;
+    // GetBillingTimeRested() → the account's rested billing MINUTES, as one number, always
+    // (decision 1820; binding `0x48ec50`, byte-VERIFIED). The body has no `jcc` at all and ends in
+    // an unconditional `mov eax,1`, and both callees are branchless and call-free — so it can never
+    // return nil and never return zero values, which is why this is not the `Value::Nil` shape its
+    // neighbours use. The engine applies NO conversion: `0x48ec5e` is a bare unsigned u32→double
+    // push, so "minutes" is the server's convention, corroborated by stock `PlayerFrame.lua:246`
+    // dividing by 60 against `REQUIRED_REST_HOURS = 5`.
+    //
+    // Against vmangos this reads 0, because the server hardcodes `uint32(0)` for the field
+    // (`World.cpp:331`). It is fed from the wire rather than pinned to a constant so a server that
+    // populates it is reported honestly. Note the reference only ever reaches this call from
+    // INSIDE `if PartialPlayTime() ... elseif NoPlayTime()`, so with those bits clear stock
+    // FrameXML never calls it — it has to exist for the file to load, and is off the live path.
+    g.set(
+        "GetBillingTimeRested",
+        lua.create_function(|lua, ()| {
+            let model = lua.app_data_ref::<Model>().expect("model app_data");
+            Ok(Value::Number(f64::from(model.billing_time_rested)))
+        })?,
+    )?;
     // GetTimeToWellRested() → nil, always — `0x48d4b0`, byte-VERIFIED: the whole binding is 11
     // bytes, `pushnil; return 1`. FrameXML's EXHAUST_TOOLTIP4 countdown branch is dead in 5875.
     g.set(
diff --git a/crates/benilla-ui/src/script/unit/mod.rs b/crates/benilla-ui/src/script/unit/mod.rs
index 69fb1c29..f02cb912 100644
--- a/crates/benilla-ui/src/script/unit/mod.rs
+++ b/crates/benilla-ui/src/script/unit/mod.rs
@@ -182,6 +182,15 @@ pub struct UnitState {
     /// This token is a PLAYER character (guid family) — the unit tooltip's level line renders
     /// "Race Class (Player)" instead of the creature type (decision 0276's verified law).
     pub is_player: bool,
+    /// This token is **player-CONTROLLED** — `UNIT_FIELD_FLAGS` bit 3
+    /// (`UNIT_FLAG_PVP_ATTACKABLE 0x8`, behaviourally "player-controlled"; the same bit
+    /// `target::relations::ring_reaction`'s duel leg selects on). Wider than
+    /// [`Self::is_player`]: a player's pet and a charmed creature are player-controlled without
+    /// being players, which is exactly the distinction stock `UnitFrame_OnEnter`
+    /// (UnitFrame.lua:58) needs when it decides whether the hovered plate gets the
+    /// player-options newbie tip. `UnitIsPlayer`'s note used to call this reach a gap we did not
+    /// carry; the unit-frame migration is what closed it.
+    pub player_controlled: bool,
     /// The unit's guild membership (`GetGuildInfo(unit)`, decision 1257). `None` = guildless, or
     /// a creature, or a player whose `PLAYER_GUILDID` has not streamed yet. Filled from the
     /// PUBLIC descriptor fields 191/192 joined against the app's guild-identity cache — see
@@ -221,12 +230,16 @@ pub struct UnitState {
     pub faction_name: Option<String>,
     /// Connection to the server is live (`UnitIsConnected`) — an offline party member's portrait
     /// desaturates (decision 0434 §2/§3: the `GROUP_LIST` status byte's `0x01` online bit).
-    /// **v1 default gap, stated not hidden:** the zero value is `false`, so a snapshot built via
-    /// `..Default::default()` reports a unit disconnected unless the app sets this explicitly; the
-    /// per-frame feed must set it `true` for every *live* unit token it pushes (mirroring
-    /// [`Self::exists`]) — a pending app-side change, not yet wired as of this field's addition. A
-    /// token absent from the store (`UnitExists` false) still reports nil regardless, via the same
-    /// "no snapshot" path every other predicate here uses.
+    /// **The zero value is `false`**, so a snapshot built via `..Default::default()` reports a unit
+    /// DISCONNECTED — which matters more than it reads: stock `UnitFrameManaBar_Update`
+    /// (UnitFrame.lua:213) greys a disconnected unit's bar and never reaches the power colour at
+    /// all. A synthetic unit that means to be live must say so.
+    ///
+    /// The app's own feed does (`ui_unit::snapshot`, "the stated `is_connected` gap, closed"), and
+    /// the party feed reads the roster status byte's `0x01` for its tokens. This doc used to call
+    /// that "a pending app-side change, not yet wired"; it has been wired since, and the note
+    /// outlived it. A token absent from the store (`UnitExists` false) still reports nil
+    /// regardless, via the same "no snapshot" path every other predicate here uses.
     pub is_connected: bool,
     /// Away-from-keyboard (`UnitIsAFK` — decision 0434 §2's status-byte `0x40` bit). The party
     /// frame's name line and chat both key off it. App-resolved; `false` until the feed lands.
@@ -451,6 +464,38 @@ impl super::UiScript {
         model.resting = resting;
     }
 
+    /// Push the two **play-time** bits of `PLAYER_FLAGS` — 12 (`PartialPlayTime`) and 13
+    /// (`NoPlayTime`), decision 1746. Taken together for the same reason the rest trio is:
+    /// stock `PlayerFrame_UpdatePlaytime` (PlayerFrame.lua:244) tests them as an if/elseif pair
+    /// and a half-updated pair would paint the wrong one of the two icons.
+    pub fn set_play_time(&mut self, partial: bool, none: bool) {
+        let mut model = self.model_mut();
+        model.partial_play_time = partial;
+        model.no_play_time = none;
+    }
+
+    /// Push the account's **rested billing minutes**, from the `SMSG_AUTH_RESPONSE` that admitted
+    /// the session — what `GetBillingTimeRested()` returns (decision 1820). Set once at login: the
+    /// client parks it in a process-lifetime global and nothing else on the wire ever writes it.
+    pub fn set_billing_time_rested(&mut self, minutes: u32) {
+        self.model_mut().billing_time_rested = minutes;
+    }
+
+    /// Enter the **UI-load sound-suppression scope** — the reference's `0x458f50`, an `inc` on the
+    /// counted depth every name-keyed `PlaySound` reads. Counted, not a flag, exactly as the
+    /// client has it: nesting is legal and only the outermost exit re-enables sound.
+    pub fn push_sound_suppression(&self) {
+        let mut model = self.model_mut();
+        model.sound_suppression = model.sound_suppression.saturating_add(1);
+    }
+
+    /// Leave it — `0x458f60`'s `dec`. Saturating on the way down too: an unbalanced pop is a bug
+    /// in the caller, and silently wrapping to a permanently-muted UI would be the worse failure.
+    pub fn pop_sound_suppression(&self) {
+        let mut model = self.model_mut();
+        model.sound_suppression = model.sound_suppression.saturating_sub(1);
+    }
+
     /// Push whether a cinematic is playing — what `InCinematic()` answers.
     pub fn set_in_cinematic(&mut self, playing: bool) {
         self.model_mut().in_cinematic = playing;
diff --git a/crates/benilla-world/src/liquid/drift.rs b/crates/benilla-world/src/liquid/drift.rs
new file mode 100644
index 00000000..7e20d411
--- /dev/null
+++ b/crates/benilla-world/src/liquid/drift.rs
@@ -0,0 +1,930 @@
+//! The underwater **drift cloud** — the 4000-mote field the reference draws while the camera eye
+//! is inside a liquid (decision 1814).
+//!
+//! Ground truth: wow-re `system/lighting/scratch/drift-cloud-emission-law.md`, a §5 six-worker
+//! round commissioned for this build, plus the difftested kernel transcription in wow-re
+//! `crates/lighting/src/drift.rs`. The object is `World.cpp`'s own — `0xfa40` bytes from
+//! `0x66f971`, ctor `0x68e5a0`, held by the pointer `[0xc63180]` — and it is **not** part of the
+//! weather manager `[0xc6326c]`: the two share no state and no code (verified by complete
+//! enumeration; 12 references to the cloud, none in the CMapWeather band).
+//!
+//! ## The shape
+//!
+//! 4000 records of 16 bytes — `xyz` **camera-relative**, plus a per-particle billboard edge. They
+//! sit in a 30 yd cube centred on the eye and are advected by `p += (last_cam − cam) + gust`, each
+//! axis wrapped back into `±15`: the cloud is therefore **world-fixed** apart from the gust, and
+//! the wrap recycles a mote the moment it leaves the box. Nothing is spawned or killed — there is
+//! no lifetime, no emitter, and no per-particle recycle; the whole field is re-scattered only on a
+//! liquid-type change or a teleport.
+//!
+//! Both drive sites — the advect `0x66fee0` and the draw `0x6701e0` — carry the same two
+//! conjuncts: the render-flag bit `[0xc7b2a4] & 0x2000000` and `[0xc7f288] != 0xf`, the
+//! **camera-eye** liquid type. That second one is [`Underwater`], which benilla's murk already
+//! gates on, so the motes appear exactly when the murk does.
+//!
+//! ## Where it draws
+//!
+//! `0x483731`, between the ground-target reticle's liquid pass and the glare dispatch — after the
+//! water surface **and** both M2 transparent passes, i.e. the last world content in the frame.
+//! [`Rung::DRIFT_CLOUD`](crate::sky_order::Rung::DRIFT_CLOUD) is that slot on our ladder.
+//!
+//! Render state is unusually plain: alpha blend, depth test on, **depth write off**, lighting off,
+//! immediate `0xFFFFFFFF` white, and fog **off** for water/ocean (on only for magma). No
+//! LightParams value reaches a mote — the draw contains zero indirect calls and the colour is a
+//! compile-time immediate — so the motes are full-brightness texels over the fogged scene and take
+//! **no** underwater tint. That is worth stating because it is the opposite of the obvious guess.
+//!
+//! ## Where we knowingly differ from the bytes
+//!
+//! Four places, each a deliberate call rather than a gap — the reasoning is in decision 1814:
+//!
+//! 1. **[`GUST_REF_HZ`]** — the reference's water gust is a per-*frame* displacement with no `dt`
+//!    term, so its drift speed scales with frame rate. We normalise it to 60 fps.
+//! 2. **Atlas cell 12 is completed.** The reference's UV initialiser stops two floats early and
+//!    one magma mote in four draws a sprite smeared across the atlas diagonal — a shipped defect
+//!    ([`ATLAS`]).
+//! 3. **The cell walk has no off-by-one.** The reference reads its cell index at the *bottom* of
+//!    the draw loop, so the value lands on the next mote and slot 0 takes a hardcoded cell 8.
+//! 4. **The cull cone is floored at the frustum** ([`cull_limits`]) — its hardcoded 90° contains
+//!    the view at every aspect the reference shipped for, and stops doing so around 21:9.
+
+use bevy::prelude::*;
+
+use benilla_formats::Submersion;
+
+use crate::particles::buffer::{
+    begin_effect_frame, EffectBlend, EffectDrawSpec, EffectFog, EffectLighting, EffectQuads,
+    EffectVertex,
+};
+use crate::particles::emit::rand01;
+use crate::sky_order::Rung;
+use crate::view::WorldCamera;
+
+use super::Underwater;
+
+/// Pool size — `count = __ftol(1.0 * [0x81038c])`, `[0x81038c] = 4000.0f`, and `0x68e650` has
+/// exactly **one** caller (the ctor, with that literal). No CVar, console command or quality tier
+/// scales it: 4000 is not a capacity, it is the population.
+const COUNT: usize = 4000;
+
+/// The wrap box's edge (`+0xfa1c`, ctor literal `30.0f`; `0x68e680` has one caller). The motes
+/// live in `[−15, +15)` per axis, camera-relative.
+const BOX_EDGE: f32 = 30.0;
+const BOX_HALF: f32 = BOX_EDGE * 0.5;
+
+/// A camera jump this big in ONE frame re-scatters the field (`0x68e99a` loads the *extent*, not
+/// the half — and `last_cam` is rewritten every frame, so this is a per-frame delta). It is a
+/// teleport detector, not a box re-centre: the box re-centres for free via the `+= delta` term.
+const TELEPORT: f32 = BOX_EDGE;
+
+/// The per-particle scale base (`+0xfa18`), re-set per liquid class by `0x68e670`: `1/36` for
+/// water and ocean (`0x680b1d`), `1/9` for magma (`0x680b5c`). A mote's edge is drawn uniformly
+/// from `[base·0.5, base·1.5)`, so water motes are **1.4–4.2 cm** across and magma's 5.6–16.7 cm.
+const SCALE_WATER: f32 = 1.0 / 36.0;
+const SCALE_MAGMA: f32 = 1.0 / 9.0;
+
+/// Gust frequency (`[0x807a4c]`) and amplitude (`[0x807a3c]`) unit scales; each is drawn as
+/// `m · scale` with `m ∈ [1,2)`, giving freq `[0.0125, 0.025)` and amp `[0.005, 0.01)`.
+const GUST_FREQ_UNIT: f32 = 0.0125;
+const GUST_AMP_UNIT: f32 = 0.005;
+
+/// The vertical squash on a freshly rolled gust direction (`[0x8029b0]`), applied **before**
+/// normalising.
+///
+/// It is a bias, **not a bound** — a correction to the RE note's first reading, checked at the
+/// difftested transcription and by Monte Carlo. `|z|/|xy| = 0.25·|cot a|` with `a` uniform on
+/// `[−π, π)`, so `atan(0.25) = 14.04°` is the **median** elevation (quartiles 5.9°/31.1°): about
+/// 15.6% of rolls are steeper than 45° and the limit as `a → 0` is straight up. The one hard
+/// constraint is the `fchs` at `0x68e27d`, which forces `z ≥ 0` — the gust never blows downward.
+const GUST_RISE: f32 = 0.25;
+
+/// Magma's motion is not a gust at all: a true velocity of `0.02` yd/s **downward**
+/// (`[0x86a098]`), and the one mode that is `dt`-scaled in the reference.
+const MAGMA_SINK: f32 = -0.02;
+
+/// The frame rate the water gust is denominated in — **our deviation, and the whole of it.**
+///
+/// `0x68e4f0`'s `mode <= 1` leg writes `out = sin(term·2π)·amp·dir` and the advect adds it to the
+/// position **with no `dt` factor** (the RE round flagged this as load-bearing; only magma's leg
+/// multiplies by `dt`). So the reference's mote drift is frame-rate dependent: at **peak** of the
+/// half-sine, ~0.3 yd/s at 30 fps, ~0.6 at 60, and ~1.2 on the 120 Hz panel this is being built on
+/// — a gust's *mean* is `2/π` of that, so ~0.19–0.38 yd/s at 60. (Peak and mean are labelled here
+/// because the RE's own table shipped one as the other for a day; the ratio, which is what this
+/// constant is about, is the same either way.) There is no single faithful speed to port — the
+/// binary's own answer spans 2× across the era's hardware — so reproducing the literal per-frame
+/// step would not be "the reference's speed", it would be *this machine's*.
+///
+/// We take the top of the era's range, 60 Hz, and scale by `dt·60`. This is the same move as the
+/// snow flake's [`SNOW_PX_REF_HEIGHT`](crate::weather::precip): denominate the reference's
+/// frame-quantised number in the era's own units so the *behaviour* carries over to hardware it
+/// never ran on, rather than the literal number carrying over and the behaviour changing.
+const GUST_REF_HZ: f32 = 60.0;
+
+/// The draw's own cap: `0x68f2cd` stops the fill at `0xa68` bytes = 2664 verts = **666 quads**.
+/// It is not arbitrary — a uniform 4000-particle cube contributes ~1/6 of itself to a 90° cone, so
+/// the cap is sized to the expected survivor count and almost never actually bites.
+const SUBMIT_CAP: usize = 666;
+
+/// The atlas cell pitch, `[0x810334] = 51/256`.
+const CELL: f32 = 51.0 / 256.0;
+
+/// The `Textures\WaterPoop02.blp` atlas as `(column, row)` cells — the lattice the CRT initialiser
+/// `[0x68ebf0, 0x68efae)` fills, recovered by emulating it. Four columns per row, plus cell 8
+/// alone out at column 4 of row 0.
+///
+/// **Cell 12 is completed here and is not in the binary.** The initialiser's last store is
+/// `0x68efa5` and its `ret` is `0x68efae`, so cell 12 gets 6 of its 8 floats and its bottom-right
+/// corner keeps BSS zero — sampling UV `(0,0)` and smearing the sprite across the atlas diagonal.
+/// The magma row uses cell 12 for one mote in four, so a faithful port would ship a visible defect
+/// on a quarter of the motes in every lava pool. Writing it as the lattice plainly intends is the
+/// §3 call (implement the mechanism, not the quirk); 1814 records it.
+const ATLAS: [(f32, f32); 13] = [
+    (0.0, 0.0),
+    (1.0, 0.0),
+    (2.0, 0.0),
+    (3.0, 0.0),
+    (0.0, 1.0),
+    (1.0, 1.0),
+    (2.0, 1.0),
+    (3.0, 1.0),
+    (4.0, 0.0),
+    (0.0, 2.0),
+    (1.0, 2.0),
+    (2.0, 2.0),
+    (3.0, 2.0),
+];
+
+/// Which atlas cells a mode draws from (`[0x86a0a0]`): water and ocean cycle cells 0–7, magma
+/// cycles 9–12.
+const CELLS_WATER: [usize; 8] = [0, 1, 2, 3, 4, 5, 6, 7];
+const CELLS_MAGMA: [usize; 8] = [9, 10, 11, 12, 9, 10, 11, 12];
+
+/// The cull's per-axis tangent limits — the reference's cone, floored at the frustum.
+///
+/// `0x68f1c9` culls to `vz > 0 && |vx| < vz && |vy| < vz`: a fixed **90° cone** about the view
+/// axis, not the real frustum, and it is what sizes [`SUBMIT_CAP`]. At every aspect the reference
+/// shipped for, that cone comfortably contains the view — 4:3 with its ~44.1° vertical fov puts
+/// the horizontal half-angle at 28.4°, a 16.6° margin — so the two never disagreed.
+///
+/// They do on a modern window. The horizontal half-fov reaches the cone's 45° at about **21:9**
+/// and passes it beyond: taken literally, a 32:9 monitor would show motes winking out in two
+/// vertical bands down the left and right edges of the screen. That is not a defect the reference
+/// has and it is not one worth importing, so the limit is the **wider** of the two. On 4:3 and
+/// 16:9 this is exactly the reference's cone and nothing changes; only an aspect the reference
+/// never ran at sees a difference, which is the same shape of call as [`GUST_REF_HZ`].
+///
+/// Vertically the cone always wins (`tan 22.5° = 0.414`), so the `max` there is a statement of
+/// that fact rather than a live term.
+fn cull_limits(fov_y: f32, aspect: f32) -> (f32, f32) {
+    let ty = (fov_y * 0.5).tan();
+    ((ty * aspect).max(1.0), ty.max(1.0))
+}
+
+/// One mote — the reference's 16-byte record exactly: a camera-relative position and the
+/// billboard's world edge length.
+#[derive(Clone, Copy, Default)]
+struct Mote {
+    pos: Vec3,
+    edge: f32,
+}
+
+/// Which liquid class the field is configured for. Slime is absent on purpose: its arm of the
+/// dispatch (`0x680b6f`) clears the enable byte and does **not** re-scatter — there are no motes
+/// in slime.
+#[derive(Clone, Copy, PartialEq, Eq, Debug)]
+enum DriftMode {
+    /// Liquid types 0 and 1 — water and ocean.
+    Water,
+    /// Liquid type 2.
+    Magma,
+}
+
+impl DriftMode {
+    fn scale_base(self) -> f32 {
+        match self {
+            DriftMode::Water => SCALE_WATER,
+            DriftMode::Magma => SCALE_MAGMA,
+        }
+    }
+
+    fn cells(self) -> &'static [usize; 8] {
+        match self {
+            DriftMode::Water => &CELLS_WATER,
+            DriftMode::Magma => &CELLS_MAGMA,
+        }
+    }
+
+    /// Fog is enabled for magma alone (`0x68f36e` sets gx id `0x0f` to `mode == 2`). Water motes
+    /// burn at full brightness over the murk.
+    fn fog(self) -> EffectFog {
+        match self {
+            DriftMode::Water => EffectFog::Off,
+            DriftMode::Magma => EffectFog::Scene,
+        }
+    }
+}
+
+/// The mote field. One resource, allocated once (64 KB) and never resized — the reference builds
+/// its object at process init and tears it down at exit.
+#[derive(Resource)]
+pub(super) struct DriftCloud {
+    motes: Vec<Mote>,
+    /// The camera position at the previous advect (`+0xfa04`).
+    last_cam: Vec3,
+    /// `None` = the enable byte is clear: never configured, or slime.
+    mode: Option<DriftMode>,
+    /// What [`Underwater`] said last frame — the reference compares the new liquid type against
+    /// `[0xc7f288]` and skips the whole reconfiguration when it is unchanged.
+    was: Submersion,
+    gust_dir: Vec3,
+    gust_freq: f32,
+    gust_phase: f32,
+    gust_amp: f32,
+    rng: u32,
+    /// `$WOW_NO_PARTICLES` — the family's perf-bisect kill switch (`particles.rs`,
+    /// `ribbons.rs`): one switch, whole family, and a mote field is squarely in it. Cached at
+    /// construction rather than read per frame.
+    off: bool,
+    /// Instrument state — see [`dump`].
+    dump: bool,
+    dump_at: f64,
+    submitted: usize,
+    wrapped: usize,
+}
+
+impl Default for DriftCloud {
+    fn default() -> Self {
+        Self {
+            motes: vec![Mote::default(); COUNT],
+            last_cam: Vec3::ZERO,
+            mode: None,
+            was: Submersion::Dry,
+            gust_dir: Vec3::X,
+            gust_freq: GUST_FREQ_UNIT,
+            gust_phase: 0.0,
+            gust_amp: GUST_AMP_UNIT,
+            // Any odd seed: the reference's lagged-table generator is byte-known, but nothing here
+            // needs its exact stream — only uniformity (the `particles::emit` idiom, and the same
+            // ruling `weather::precip::rand01` carries).
+            rng: 0x9e37_79b9,
+            off: std::env::var_os("WOW_NO_PARTICLES").is_some(),
+            dump: std::env::var_os("WOW_DRIFT_DUMP").is_some(),
+            dump_at: 0.0,
+            submitted: 0,
+            wrapped: 0,
+        }
+    }
+}
+
+impl DriftCloud {
+    /// Scatter every mote uniformly through the box and redraw its edge — `0x68e720`. Called on a
+    /// liquid-type change and on a teleport, never per frame and never per mote at the wrap.
+    fn scatter(&mut self, mode: DriftMode) {
+        let base = mode.scale_base();
+        let lo = base * 0.5;
+        let span = base * 1.5 - lo;
+        let mut rng = self.rng;
+        for m in &mut self.motes {
+            // Uniform in `[−15, +15)` per axis: the reference's `(m − 1)·extent − half`.
+            m.pos = Vec3::new(
+                rand01(&mut rng) * BOX_EDGE - BOX_HALF,
+                rand01(&mut rng) * BOX_EDGE - BOX_HALF,
+                rand01(&mut rng) * BOX_EDGE - BOX_HALF,
+            );
+            m.edge = rand01(&mut rng) * span + lo;
+        }
+        self.rng = rng;
+        self.mode = Some(mode);
+    }
+
+    /// Roll a fresh gust — `0x68e1c0`. Two uniform angles on `[−π, π)`; the vertical term is
+    /// squashed by [`GUST_RISE`] and forced non-negative before the direction is normalised, then
+    /// a fresh period and amplitude.
+    fn roll_gust(&mut self) {
+        let mut rng = self.rng;
+        let angle = |r: &mut u32| (rand01(r) * 2.0 - 1.0) * std::f32::consts::PI;
+        let (sa, ca) = angle(&mut rng).sin_cos();
+        let (se, ce) = angle(&mut rng).sin_cos();
+        // WoW z is up, Bevy y is up: the reference's (x, y, z) is our (x, z, y).
+        let dir = Vec3::new(ce * sa, (ca * GUST_RISE).abs(), se * sa);
+        self.gust_dir = dir.normalize_or(Vec3::Y);
+        self.gust_freq = (1.0 + rand01(&mut rng)) * GUST_FREQ_UNIT;
+        self.gust_amp = (1.0 + rand01(&mut rng)) * GUST_AMP_UNIT;
+        self.gust_phase = 0.0;
+        self.rng = rng;
+    }
+
+    /// This frame's whole-field displacement — `0x68e4f0`.
+    fn gust(&mut self, mode: DriftMode, dt: f32) -> Vec3 {
+        match mode {
+            DriftMode::Magma => Vec3::new(0.0, MAGMA_SINK * dt, 0.0),
+            DriftMode::Water => {
+                self.gust_phase += dt;
+                let mut term = self.gust_phase * self.gust_freq;
+                // Strictly greater (`0x68e542 test ah,0x41; jne`): the period runs 20 s at the
+                // fastest frequency to 40 s at the slowest, and `sin(term·2π)` over `[0, 0.5]` is a
+                // non-negative half-sine — the gust swells from nothing to a peak and back, then
+                // takes a new direction.
+                if term > 0.5 {
+                    self.roll_gust();
+                    term = 0.0;
+                }
+                let speed = (term * std::f32::consts::TAU).sin() * self.gust_amp;
+                // The one deviation: `· dt · 60` where the reference has no `dt` at all.
+                self.gust_dir * (speed * dt * GUST_REF_HZ)
+            }
+        }
+    }
+
+    /// Advance the field — `0x68e930`. Because the records are camera-relative and `delta` is the
+    /// camera's *backwards* step, the cloud stands still in the world; only the gust moves it.
+    fn advect(&mut self, mode: DriftMode, eye: Vec3, dt: f32) {
+        let mut delta = self.last_cam - eye;
+        self.last_cam = eye;
+        if delta.length_squared() > TELEPORT * TELEPORT {
+            self.scatter(mode);
+            delta = Vec3::ZERO;
+        }
+        let add = delta + self.gust(mode, dt);
+        let wrap = |v: f32| {
+            if v > BOX_HALF {
+                v - BOX_EDGE
+            } else if v < -BOX_HALF {
+                v + BOX_EDGE
+            } else {
+                v
+            }
+        };
+        let mut wrapped = 0usize;
+        for m in &mut self.motes {
+            let moved = m.pos + add;
+            m.pos = Vec3::new(wrap(moved.x), wrap(moved.y), wrap(moved.z));
+            if m.pos != moved {
+                wrapped += 1;
+            }
+        }
+        self.wrapped = wrapped;
+    }
+}
+
+/// The mote texture. One BLP, loaded once with the world's first camera.
+#[derive(Resource)]
+struct DriftAssets {
+    motes: Handle<Image>,
+}
+
+fn setup_drift(
+    mut commands: Commands,
+    asset_server: Res<AssetServer>,
+    cam: Query<&GlobalTransform, With<WorldCamera>>,
+    existing: Option<Res<DriftAssets>>,
+) {
+    if existing.is_some() || cam.single().is_err() {
+        return;
+    }
+    // `PointSprite` — clamp, the gamma lane, and the BLP's **authored mip pyramid**. A mote is
+    // 1.4–4.2 cm wide and lives out to 26 yd, which on this projection is ~87 px at arm's length
+    // down to ~3 px at the box corner: a 17× minification of a 51 px atlas cell. Mip-0-only there
+    // is the snow flake's flickering speckle (`BlpVariant::Effect`'s docs), not crispness. The
+    // cost is that the deep mips blend neighbouring cells — which the reference pays too, having
+    // shipped the same atlas with the same 8 mips and bound it with the same filtering.
+    let point_sprite = |s: &mut benilla_assets::BlpLoaderSettings| {
+        s.variant = benilla_assets::BlpVariant::PointSprite;
+    };
+    commands.insert_resource(DriftAssets {
+        motes: asset_server.load_with_settings("mpq://textures/waterpoop02.blp", point_sprite),
+    });
+}
+
+/// Reconfigure on a liquid-class change, then advect — the reference's update-pass leg
+/// (`0x66fee0` → `0x68e930`), with `0x6809c0`'s type dispatch folded in ahead of it.
+fn simulate_drift(
+    mut cloud: ResMut<DriftCloud>,
+    underwater: Res<Underwater>,
+    cam: Query<&GlobalTransform, With<WorldCamera>>,
+    time: Res<Time>,
+) {
+    let Ok(cam_tf) = cam.single() else {
+        return;
+    };
+    let eye = cam_tf.translation();
+    let now = underwater.0;
+    if now != cloud.was {
+        cloud.was = now;
+        match now {
+            // Going dry does NOT clear the enable byte — `0x680abe` intercepts `0xf` before the
+            // type dispatch, so the field keeps its configuration and is suppressed by the frame
+            // gate alone. Diving back into the same liquid therefore finds it exactly as it was.
+            Submersion::Dry => {}
+            // Slime disables outright, with no re-scatter (`0x680b6f`).
+            Submersion::Slime => cloud.mode = None,
+            Submersion::Water => {
+                cloud.scatter(DriftMode::Water);
+                cloud.last_cam = eye;
+            }
+            Submersion::Magma => {
+                cloud.scatter(DriftMode::Magma);
+                cloud.last_cam = eye;
+            }
+        }
+    }
+    // The frame gate's second conjunct. (The first, the render-flag bit `0x2000000`, is the
+    // `waterParticulates` console command's latch — default ON, a plain on/off that scales
+    // nothing, and not a CVar at all: it is registered through the developer-console table
+    // `0x63f9e0`, has no `CVar::Register` site and no `Config.wtf` persistence. Nothing here
+    // wires it, exactly as nothing wires `showfootprints`.)
+    if !now.any() || cloud.off {
+        return;
+    }
+    let Some(mode) = cloud.mode else {
+        return;
+    };
+    cloud.advect(mode, eye, time.delta_secs());
+}
+
+/// Emit the surviving motes into the shared effect stream — the reference's render-pass leg
+/// (`0x6701e0` → `0x68efe0`).
+fn push_drift(
+    mut cloud: ResMut<DriftCloud>,
+    underwater: Res<Underwater>,
+    assets: Option<Res<DriftAssets>>,
+    cam: Query<(Entity, &GlobalTransform, &Projection), With<WorldCamera>>,
+    mut quads: ResMut<EffectQuads>,
+    time: Res<Time>,
+) {
+    cloud.submitted = 0;
+    // Every exit yields a REASON rather than returning, so the instrument can say why nothing drew.
+    // A census that goes silent when the thing is off cannot tell "off" from "broken" — which is
+    // exactly the hole the first live probe of this module fell into.
+    let status: &'static str = 'draw: {
+        // The same two conjuncts as the advect — the draw is independently gated, not a consequence of
+        // the sim having run.
+        if !underwater.0.any() {
+            break 'draw "dry (the eye is not in a liquid)";
+        }
+        if cloud.off {
+            break 'draw "off ($WOW_NO_PARTICLES)";
+        }
+        let Some(mode) = cloud.mode else {
+            break 'draw "disabled (slime, or never configured)";
+        };
+        let Some(assets) = assets else {
+            break 'draw "no texture resource yet";
+        };
+        let Ok((cam_entity, cam_tf, proj)) = cam.single() else {
+            break 'draw "no world camera";
+        };
+        let (tan_x, tan_y) = match proj {
+            Projection::Perspective(p) => cull_limits(p.fov, p.aspect_ratio),
+            // No perspective divide, so the cone means nothing; the reference has no such mode.
+            _ => (1.0, 1.0),
+        };
+        let eye = cam_tf.translation();
+        let fwd = cam_tf.forward().as_vec3();
+        let right = cam_tf.right().as_vec3();
+        let up = cam_tf.up().as_vec3();
+        let cells = mode.cells();
+
+        let start = quads.begin();
+        let mut submitted = 0usize;
+        for (i, m) in cloud.motes.iter().enumerate() {
+            if submitted == SUBMIT_CAP {
+                break;
+            }
+            // The reference's cone, floored at the frustum — see [`cull_limits`].
+            let rel = m.pos;
+            let vz = rel.dot(fwd);
+            if vz <= 0.0 {
+                continue;
+            }
+            if rel.dot(right).abs() >= vz * tan_x || rel.dot(up).abs() >= vz * tan_y {
+                continue;
+            }
+            let (col, row) = ATLAS[cells[i & 7]];
+            let (u0, v0) = (col * CELL, row * CELL);
+            let half = m.edge * 0.5;
+            let r = right * half;
+            let u = up * half;
+            // Perimeter order (bl, br, tr, tl) — the stream's quad-index pattern closes it. The
+            // vertices are camera-RELATIVE (`cam_relative` below), which is what the record already
+            // holds; the reference does the same thing by handing the device only the projection.
+            for (pos, uv) in [
+                (rel - r - u, [u0, v0 + CELL]),
+                (rel + r - u, [u0 + CELL, v0 + CELL]),
+                (rel + r + u, [u0 + CELL, v0]),
+                (rel - r + u, [u0, v0]),
+            ] {
+                quads.verts.push(EffectVertex {
+                    pos: pos.to_array(),
+                    uv,
+                    // The colour is an immediate `0xFFFFFFFF` in the binary (`0x68f27b`): not
+                    // per-particle, not a global, and with no distance or depth fade.
+                    color: [1.0, 1.0, 1.0, 1.0],
+                });
+            }
+            submitted += 1;
+        }
+        quads.commit_quads(
+            start,
+            EffectDrawSpec {
+                cam: cam_entity,
+                texture: assets.motes.id(),
+                // `SRC_ALPHA / ONE_MINUS_SRC_ALPHA` (gx id 7 = 2). The cascading alpha test at
+                // `GEQUAL 1/255` needs no lane of its own — under this blend a zero-alpha fragment
+                // already contributes nothing.
+                blend: EffectBlend::Alpha,
+                fog: mode.fog(),
+                lighting: EffectLighting::None,
+                anchor: eye,
+                bias: Rung::DRIFT_CLOUD,
+                raster_bias: 0,
+                raster_slope: 0.0,
+                cam_relative: true,
+                main_entity: Entity::PLACEHOLDER,
+                light: None,
+            },
+        );
+        cloud.submitted = submitted;
+        if submitted == 0 {
+            break 'draw "submerged, but every mote culled";
+        }
+        "drawing"
+    };
+    dump(&mut cloud, status, &time);
+}
+
+/// `$WOW_DRIFT_DUMP` — a 1 Hz line, because every question this field raises is numeric and none
+/// of them is answerable from a screenshot. `submitted` against [`SUBMIT_CAP`] says whether the cap
+/// is biting; `wrapped` is the recycle rate, which is the drift speed made visible; the gust block
+/// is the only state with a 20–40 s clock on it, so a stuck gust shows here and nowhere else.
+///
+/// **It reports when nothing draws, too, and that is the point.** The first live probe of this
+/// module printed no lines at all, which was indistinguishable between "the eye never went under"
+/// and "the draw is broken" — so `status` names the gate that stopped it.
+fn dump(cloud: &mut DriftCloud, status: &'static str, time: &Time) {
+    if !cloud.dump {
+        return;
+    }
+    let now = time.elapsed_secs_f64();
+    if now - cloud.dump_at < 1.0 {
+        return;
+    }
+    cloud.dump_at = now;
+    let d = cloud.gust_dir;
+    let elev = d.y.clamp(-1.0, 1.0).asin().to_degrees();
+    info!(
+        "drift: {status} — mode {:?} submitted {}/{} (cap {}) wrapped {} | gust dir \
+         [{:.3} {:.3} {:.3}] elev {:.1}° freq {:.4} amp {:.4} phase {:.1}/{:.1}s",
+        cloud.mode,
+        cloud.submitted,
+        COUNT,
+        SUBMIT_CAP,
+        cloud.wrapped,
+        d.x,
+        d.y,
+        d.z,
+        elev,
+        cloud.gust_freq,
+        cloud.gust_amp,
+        cloud.gust_phase,
+        0.5 / cloud.gust_freq,
+    );
+}
+
+pub(super) fn register(app: &mut App) {
+    app.init_resource::<DriftCloud>()
+        .add_systems(
+            Update,
+            (
+                setup_drift,
+                // `CameraPoseSet` as well as the verdict: the advect's whole input is
+                // `last_cam − cam`, and for the length of `Update` a camera's `GlobalTransform` is
+                // last frame's pose unless you order after the set that refreshes it (1503). Read
+                // stale, a teleport's jump would land in `delta` a frame late — as a 30 yd shove
+                // through the field instead of the re-scatter it is.
+                simulate_drift
+                    .after(super::SubmersionVerdict)
+                    .after(crate::view::CameraPoseSet)
+                    .after(setup_drift),
+            ),
+        )
+        .add_systems(PostUpdate, push_drift.after(begin_effect_frame));
+}
+
+#[cfg(test)]
+mod tests {
+    use super::*;
+
+    fn cloud(mode: DriftMode) -> DriftCloud {
+        let mut c = DriftCloud::default();
+        c.scatter(mode);
+        c
+    }
+
+    fn in_box(v: Vec3) -> bool {
+        [v.x, v.y, v.z]
+            .iter()
+            .all(|c| *c >= -BOX_HALF && *c < BOX_HALF)
+    }
+
+    #[test]
+    fn scatter_fills_the_box_and_the_edge_lane() {
+        for (mode, base) in [
+            (DriftMode::Water, SCALE_WATER),
+            (DriftMode::Magma, SCALE_MAGMA),
+        ] {
+            let c = cloud(mode);
+            assert_eq!(c.motes.len(), COUNT);
+            for m in &c.motes {
+                assert!(in_box(m.pos), "{:?} outside the 30 yd box", m.pos);
+                assert!(
+                    m.edge >= base * 0.5 && m.edge < base * 1.5,
+                    "edge {} outside [{}, {})",
+                    m.edge,
+                    base * 0.5,
+                    base * 1.5
+                );
+            }
+            // A scatter that filled the box would still be wrong if it filled it in a corner: the
+            // mean of a uniform cube is the centre, and 4000 samples put it well inside 1 yd.
+            let mean: Vec3 = c.motes.iter().map(|m| m.pos).sum::<Vec3>() / COUNT as f32;
+            assert!(mean.length() < 1.0, "scatter is not centred: mean {mean:?}");
+        }
+    }
+
+    #[test]
+    fn the_wrap_keeps_every_mote_inside_the_box() {
+        let mut c = cloud(DriftMode::Water);
+        let mut eye = Vec3::ZERO;
+        // Walk the camera a long way in small steps — every step pushes motes out of the far face,
+        // and the wrap is the only thing bringing them back.
+        for _ in 0..500 {
+            eye += Vec3::new(0.4, 0.05, -0.3);
+            c.advect(DriftMode::Water, eye, 1.0 / 60.0);
+            assert!(c.motes.iter().all(|m| in_box(m.pos)));
+        }
+        assert!(c.wrapped > 0, "500 yards of walking wrapped nothing");
+    }
+
+    #[test]
+    fn the_cloud_is_world_fixed_apart_from_the_gust() {
+        let mut c = cloud(DriftMode::Water);
+        // Silence the gust so the camera term is the only motion left.
+        c.gust_amp = 0.0;
+        c.gust_freq = 0.0;
+        let world_before: Vec<Vec3> = c.motes.iter().map(|m| m.pos).collect();
+        let eye = Vec3::new(3.0, -1.0, 2.0);
+        c.advect(DriftMode::Water, eye, 1.0 / 60.0);
+        // `pos` is camera-relative, so a mote that stood still in the world must now read
+        // `old − eye` — unless it wrapped, which is a teleport in world space by design.
+        let mut checked = 0;
+        for (m, was) in c.motes.iter().zip(&world_before) {
+            let expect = *was - eye;
+            if in_box(expect) {
+                assert!(
+                    (m.pos - expect).length() < 1e-3,
+                    "mote moved in world space: {:?} vs {:?}",
+                    m.pos,
+                    expect
+                );
+                checked += 1;
+            }
+        }
+        assert!(checked > COUNT / 2, "too few unwrapped motes to prove it");
+    }
+
+    #[test]
+    fn a_teleport_rescatters_rather_than_wrapping() {
+        let mut c = cloud(DriftMode::Water);
+        c.gust_amp = 0.0;
+        let before: Vec<Vec3> = c.motes.iter().map(|m| m.pos).collect();
+        // One frame, further than the box is wide.
+        c.advect(
+            DriftMode::Water,
+            Vec3::new(0.0, 0.0, TELEPORT + 1.0),
+            1.0 / 60.0,
+        );
+        assert!(c.motes.iter().all(|m| in_box(m.pos)));
+        let moved = c
+            .motes
+            .iter()
+            .zip(&before)
+            .filter(|(m, b)| (m.pos - **b).length() > 1e-3)
+            .count();
+        // A wrap would have translated the field rigidly; a re-scatter moves essentially all of it
+        // to independent places.
+        assert!(
+            moved > COUNT * 9 / 10,
+            "only {moved} motes were re-scattered"
+        );
+    }
+
+    #[test]
+    fn the_gust_never_blows_downward_and_is_biased_horizontal_without_being_bounded() {
+        let mut c = DriftCloud::default();
+        let mut elev = Vec::new();
+        for _ in 0..20_000 {
+            c.roll_gust();
+            let d = c.gust_dir;
+            assert!(
+                (d.length() - 1.0).abs() < 1e-4,
+                "gust dir is not a unit vector"
+            );
+            // The `fchs` at `0x68e27d` — the one hard constraint on the direction.
+            assert!(d.y >= 0.0, "the gust blew downward: {d:?}");
+            elev.push(d.y.clamp(-1.0, 1.0).asin().to_degrees());
+        }
+        elev.sort_by(|a, b| a.partial_cmp(b).unwrap());
+        let median = elev[elev.len() / 2];
+        let steep = elev.iter().filter(|e| **e > 45.0).count() as f32 / elev.len() as f32;
+        // `atan(0.25)` is the MEDIAN elevation, not a bound — the RE note's first reading said
+        // "always within 14.04° of horizontal", which the formula does not support and this test
+        // exists to keep anyone from re-introducing as a clamp. Closed forms: median
+        // `atan(0.25) = 14.036°`, and `P(elev > 45°) = (2/π)·atan(0.25) = 0.156`.
+        assert!(
+            (median - 0.25f32.atan().to_degrees()).abs() < 1.0,
+            "median elevation {median} is not atan(0.25)"
+        );
+        assert!(
+            (steep - 0.156).abs() < 0.02,
+            "{steep} of rolls steeper than 45° — expected ~0.156; a clamp would read ~0"
+        );
+        assert!(
+            *elev.last().unwrap() > 80.0,
+            "the distribution is bounded — it should reach straight up"
+        );
+    }
+
+    #[test]
+    fn the_gust_period_runs_twenty_to_forty_seconds() {
+        let mut c = DriftCloud::default();
+        for _ in 0..2_000 {
+            c.roll_gust();
+            let period = 0.5 / c.gust_freq;
+            assert!(
+                (20.0..=40.0).contains(&period),
+                "gust period {period}s outside 20–40s"
+            );
+            assert!((0.005..0.01).contains(&c.gust_amp), "amp {}", c.gust_amp);
+        }
+    }
+
+    #[test]
+    fn the_water_gust_is_frame_rate_independent() {
+        // The deviation `GUST_REF_HZ` buys exactly this: the same wall-clock second of drift,
+        // whatever the frame rate. (The reference's own answer differs by 2× between 30 and 60 fps
+        // — see the constant's docs.)
+        let travel = |steps: u32, dt: f32| {
+            let mut c = DriftCloud::default();
+            c.roll_gust();
+            c.mode = Some(DriftMode::Water);
+            let dir = c.gust_dir;
+            let mut sum = 0.0;
+            for _ in 0..steps {
+                sum += c.gust(DriftMode::Water, dt).dot(dir);
+            }
+            sum
+        };
+        let at30 = travel(30, 1.0 / 30.0);
+        let at120 = travel(120, 1.0 / 120.0);
+        // 5%, not 0: the gust's half-sine envelope is being sampled, and a 30-step Riemann sum of
+        // a rising function differs from a 120-step one by O(dt). That residual is the envelope's
+        // shape, not the frame rate leaking into the speed.
+        assert!(
+            (at30 - at120).abs() / at30.abs().max(1e-6) < 0.05,
+            "one second of drift: {at30} at 30 fps vs {at120} at 120 fps"
+        );
+        // And this is what the normalisation is FOR: strip the `dt·60` back out — which is the
+        // reference's literal per-frame law — and the same second of wall clock moves the field
+        // four times further at 120 fps than at 30.
+        let literal = |steps: u32, dt: f32| travel(steps, dt) / (dt * GUST_REF_HZ);
+        let ratio = literal(120, 1.0 / 120.0) / literal(30, 1.0 / 30.0);
+        assert!(
+            (ratio - 4.0).abs() < 0.4,
+            "the literal per-frame law should scale 4× from 30 to 120 fps, read {ratio}"
+        );
+    }
+
+    #[test]
+    fn magma_sinks_at_a_true_velocity() {
+        let mut c = DriftCloud::default();
+        let a = c.gust(DriftMode::Magma, 1.0 / 30.0) * 30.0;
+        let b = c.gust(DriftMode::Magma, 1.0 / 120.0) * 120.0;
+        assert!((a.y - MAGMA_SINK).abs() < 1e-5 && (b.y - MAGMA_SINK).abs() < 1e-5);
+        assert!(a.x == 0.0 && a.z == 0.0, "magma drift is vertical only");
+    }
+
+    #[test]
+    fn the_atlas_is_a_complete_lattice_including_the_reference_s_truncated_cell() {
+        // Every cell is a distinct 51/256 tile, and no two cells overlap.
+        let mut seen = std::collections::HashSet::new();
+        for (col, row) in ATLAS {
+            assert!(col >= 0.0 && row >= 0.0);
+            assert!((col + 1.0) * CELL <= 1.0 + 1e-6, "cell runs off the atlas");
+            assert!((row + 1.0) * CELL <= 1.0 + 1e-6, "cell runs off the atlas");
+            assert!(
+                seen.insert((col as u32, row as u32)),
+                "duplicate atlas cell"
+            );
+        }
+        // Cell 12 is the one the reference leaves half-written (its bottom-right corner stays BSS
+        // zero and samples UV (0,0)). Ours is a real tile at column 3, row 2 — if this ever reads
+        // (0,0) again we have re-imported a shipped defect.
+        assert_eq!(ATLAS[12], (3.0, 2.0));
+        // And it is reachable: magma draws it for one mote in four.
+        assert!(CELLS_MAGMA.contains(&12));
+    }
+
+    #[test]
+    fn the_cull_never_clips_a_mote_that_is_on_screen() {
+        // The invariant, at every aspect a window can have: the cull limit is at least the
+        // frustum's, so nothing visible is dropped.
+        for aspect in [4.0 / 3.0, 16.0 / 10.0, 16.0 / 9.0, 21.0 / 9.0, 32.0 / 9.0] {
+            let (tx, ty) = cull_limits(crate::view::CAM_FOVY, aspect);
+            let frustum_x = (crate::view::CAM_FOVY * 0.5).tan() * aspect;
+            let frustum_y = (crate::view::CAM_FOVY * 0.5).tan();
+            assert!(
+                tx >= frustum_x,
+                "aspect {aspect}: cull {tx} < frustum {frustum_x}"
+            );
+            assert!(
+                ty >= frustum_y,
+                "aspect {aspect}: cull {ty} < frustum {frustum_y}"
+            );
+        }
+        // ...and on the aspects the reference actually ran at, the limit IS its 90° cone — the
+        // widening is inert there, so `SUBMIT_CAP`'s sizing still holds where it was derived.
+        assert_eq!(cull_limits(crate::view::CAM_FOVY, 4.0 / 3.0), (1.0, 1.0));
+        assert_eq!(cull_limits(crate::view::CAM_FOVY, 16.0 / 9.0), (1.0, 1.0));
+        // Ultrawide is where it bites, and it bites horizontally only.
+        let (tx, ty) = cull_limits(crate::view::CAM_FOVY, 32.0 / 9.0);
+        assert!(tx > 1.0 && ty == 1.0);
+    }
+
+    /// The perf gate, and it is structural rather than measured: a dry frame must commit **no
+    /// draw and no vertex**. The effect lane charges per submitted vertex, so "costs nothing when
+    /// you are not underwater" is a property of this assertion, not of a frame-rate reading on
+    /// whatever the machine was doing that afternoon (the 0353 law).
+    #[test]
+    fn a_dry_frame_commits_nothing() {
+        use bevy::ecs::system::RunSystemOnce;
+
+        let mut world = World::new();
+        world.insert_resource(EffectQuads::default());
+        world.insert_resource(Time::<()>::default());
+        world.insert_resource(DriftAssets {
+            motes: Handle::default(),
+        });
+        let mut c = DriftCloud::default();
+        c.scatter(DriftMode::Water);
+        world.insert_resource(c);
+        world.spawn((
+            WorldCamera,
+            GlobalTransform::default(),
+            Projection::default(),
+        ));
+
+        // Dry: the field is configured and the texture is present, so the ONLY thing stopping the
+        // draw is the gate.
+        world.insert_resource(Underwater(Submersion::Dry));
+        world.run_system_once(push_drift).unwrap();
+        {
+            let q = world.resource::<EffectQuads>();
+            assert!(q.draws.is_empty(), "a dry frame committed a draw");
+            assert!(q.verts.is_empty(), "a dry frame pushed vertices");
+        }
+
+        // Submerged: the same world, one resource different, and now it draws — so the assertion
+        // above is about the gate and not about a fixture that could never draw at all.
+        world.insert_resource(Underwater(Submersion::Water));
+        world.run_system_once(push_drift).unwrap();
+        {
+            let q = world.resource::<EffectQuads>();
+            assert_eq!(q.draws.len(), 1, "submerged, the cloud did not draw");
+            assert!(!q.verts.is_empty());
+            assert_eq!(q.verts.len() % 4, 0, "whole quads only");
+            assert!(
+                q.verts.len() / 4 <= SUBMIT_CAP,
+                "{} quads exceeds the reference's cap",
+                q.verts.len() / 4
+            );
+            assert_eq!(q.draws[0].bias, Rung::DRIFT_CLOUD);
+        }
+    }
+
+    #[test]
+    fn slime_has_no_motes_and_going_dry_keeps_the_configuration() {
+        let mut c = cloud(DriftMode::Water);
+        assert!(c.mode.is_some());
+        // Slime's arm clears the enable byte outright.
+        c.mode = None;
+        assert!(c.mode.is_none());
+        // ...while going dry leaves it alone: the reference intercepts `0xf` ahead of the type
+        // dispatch, so surfacing and diving again finds the same field.
+        let mut c = cloud(DriftMode::Water);
+        let before: Vec<Vec3> = c.motes.iter().map(|m| m.pos).collect();
+        c.was = Submersion::Dry;
+        assert_eq!(c.mode, Some(DriftMode::Water));
+        assert!(c.motes.iter().zip(&before).all(|(m, b)| m.pos == *b));
+    }
+}
diff --git a/crates/benilla-world/src/liquid/mod.rs b/crates/benilla-world/src/liquid/mod.rs
index 83c67825..8295d646 100644
--- a/crates/benilla-world/src/liquid/mod.rs
+++ b/crates/benilla-world/src/liquid/mod.rs
@@ -67,6 +67,10 @@
 //!   through. The once-a-frame askers keep the plain walk.
 //! * [`surface`] — **the Bevy render glue.** The per-kind animated materials, the two spawn paths
 //!   (MCLQ and WMO MLIQ), the flat mesh build, and the 24 fps frame cycler.
+//! * [`drift`] — **the underwater drift cloud**: the 4000-mote field the reference draws while the
+//!   camera eye is inside a liquid (decision 1814). It is here rather than under `weather` because
+//!   the reference keeps it that way too — the pool is CWorld's, not the weather manager's, and
+//!   the two share no state and no code — and because [`Underwater`] is its whole trigger.
 //!
 //! The one cross-feed runs query → lighting: `detect_submersion` publishes WHICH liquid the eye is
 //! in, and `lighting::update_time_lighting` selects the whole submerged atmosphere from it.
@@ -77,6 +81,7 @@ use bevy::prelude::*;
 use benilla_assets::materials::LiquidMaterial;
 use benilla_assets::AssetSet;
 
+mod drift;
 mod query;
 #[cfg(test)]
 mod real_data;
@@ -155,5 +160,8 @@ impl Plugin for LiquidPlugin {
                     .before(bevy::camera::visibility::VisibilitySystems::VisibilityPropagate)
                     .run_if(|| std::env::var_os("WOW_NO_LIQUID").is_some()),
             );
+        // The underwater drift cloud — the one thing in this subsystem that RENDERS because the
+        // eye is submerged, rather than answering where the liquid is (see the layout note above).
+        drift::register(app);
     }
 }
diff --git a/crates/benilla-world/src/particles/emit.rs b/crates/benilla-world/src/particles/emit.rs
index bec5270e..f3525817 100644
--- a/crates/benilla-world/src/particles/emit.rs
+++ b/crates/benilla-world/src/particles/emit.rs
@@ -17,7 +17,7 @@ pub(super) fn next_u32(state: &mut u32) -> u32 {
 }
 
 /// A uniform random `f32` in `[0, 1)`.
-pub(super) fn rand01(state: &mut u32) -> f32 {
+pub(crate) fn rand01(state: &mut u32) -> f32 {
     (next_u32(state) >> 8) as f32 / (1u32 << 24) as f32
 }
 
diff --git a/crates/benilla-world/src/particles/render.rs b/crates/benilla-world/src/particles/render.rs
index d147a662..25a11d72 100644
--- a/crates/benilla-world/src/particles/render.rs
+++ b/crates/benilla-world/src/particles/render.rs
@@ -384,6 +384,7 @@ fn decal_lane(bias: f32) -> Option<&'static str> {
         b if b == Rung::FOOTPRINT => Some("footprint"),
         b if b == Rung::RETICLE => Some("reticle"),
         b if b == Rung::GROUND_FX => Some("ground-fx"),
+        b if b == Rung::DRIFT_CLOUD => Some("drift-cloud"),
         _ => None,
     }
 }
diff --git a/crates/benilla-world/src/sky_order.rs b/crates/benilla-world/src/sky_order.rs
index 08150aff..832ce657 100644
--- a/crates/benilla-world/src/sky_order.rs
+++ b/crates/benilla-world/src/sky_order.rs
@@ -334,6 +334,21 @@ impl Rung {
     /// eye spends that budget: at `4.0` the wake visibly washed onto the beach, which is what the
     /// director reported twice.
     pub const FOAM_RASTER_SLOPE: f32 = 0.0;
+    /// **The underwater drift cloud** — the mote field, at the reference's own frame slot
+    /// `0x483731`: after the water surface AND both M2 transparent passes, immediately before the
+    /// glare dispatch `0x483740`. The last world content in the frame (decision 1814).
+    ///
+    /// The window is narrow and this rung is checked against its actual NEIGHBOURS rather than the
+    /// blanket 1e4, exactly as the decal band is: it has to clear
+    /// [`GROUND_FX`](Rung::GROUND_FX) below and [`GLARE_BIAS`] above, and those are only 1.18e4
+    /// apart. Centred, that leaves ~5.8e3 each side — comfortably more than the
+    /// [`WORLD_VIEW_Z_FLOOR`] spread that is the most two anchors here can differ by, since the
+    /// cloud's anchor is the eye itself and a ground-fx decal's is at most a far plane away.
+    ///
+    /// One batch for the whole field, so there is no intra-cloud sort — which is right rather than
+    /// merely cheap: the reference submits all its survivors as **one indexed triangle list**
+    /// (`0x68f3c9`) in slot order, with depth WRITE off and no per-mote ordering anywhere.
+    pub const DRIFT_CLOUD: f32 = 1.4e4;
     /// **World text** — above the celestial glare, so a flare never washes a nameplate, and above
     /// every sky rung. The reference draws its world text late in the frame (decision 0519).
     /// Small on purpose: 6× the far plane is all the ordering needs, and this same field doubles
@@ -368,6 +383,12 @@ const _: () = {
     assert!(Rung::GROUND_FX - CLOUDS_BIAS > 1.0e4);
     assert!(GLARE_BIAS - Rung::GROUND_FX > 1.0e4);
     assert!(Rung::NAMEPLATE - GLARE_BIAS > 1.0e4);
+    // The drift cloud sits between the ground-fx decals and the glare — the reference's `0x483731`,
+    // the frame's last world draw. Its window is 1.18e4 wide, so like the decal band it is measured
+    // against its neighbours rather than the blanket: the margin only has to beat the view-z spread
+    // two anchors here can differ by, and the cloud's anchor IS the eye.
+    assert!(Rung::DRIFT_CLOUD - Rung::GROUND_FX > -WORLD_VIEW_Z_FLOOR);
+    assert!(GLARE_BIAS - Rung::DRIFT_CLOUD > -WORLD_VIEW_Z_FLOOR);
     // The raster margins are their own axis (B131) — not comparable to the sort rungs above, only
     // to zero and to each other. One number for every ground decal (1817); the foam is not one of
     // them, and takes far less.