benilla-octo/crates/benilla-app/src/ui_script/options_tests.rs

//! The shipped `assets/ui/OptionsFrame.xml` — the era-shaped, 1.12-skinned options window
//! (0950: the shell; 0957: the Audio page; 0959: the Graphics page; 0978: the 1.12-native
//! skin — no era extraction, every texture from the MPQ chain; 0981: the 1.14 System-window
//! dialog chrome — translucent dark ground, outline boxes, hairline dividers; 0984: the 1.14
//! select/hover wash mechanism, the working era search; 0985: the provenance split those
//! cite; 0989: the directed cuts — steppers and the corner X gone, the whole bar live via
//! the engine's track-press law, the search box at the era's verbatim seat; 0992: the
//! dropdown row shape on the 1.12 kit — Environment Detail — and the Nameplates page's
//! three UnitName* rows; 1476: the ground dim — a black fill over the 0.6 tile, seated clear
//! of the rope's ink, because a 60% veil is not a page you can read over bright terrain).
//!
//! What these guard: the file loads clean inside the real neighbourhood (Fonts + UiPanels +
//! GameMenuFrame); the menu's Options button is the door in (menu down, options up, on the ref's
//! own kit); Controls is the default category and the page title follows the selection; both
//! close spellings put the window away; the selected row wears the LOCKED GOLD additive wash
//! and hover runs the steel-blue one (the 1.14 pair); and the search reflows the live rows
//! under category heads and restores the authored page exactly.
//!
//! The page tests (0957 Audio, 0959 Graphics) run against the REAL registered CVar set
//! (`crate::cvars`): rows read the table on select, writes land on the change queue the host
//! drains, the snap grids and readouts hold (the era 5% volumes; the 1.12 uiscale 0.01 and
//! farclip min-anchored 60), the 1.12 master→ambience dependency greys, and Defaults walks the
//! visible page back to the registered defaults.

use benilla_ui::script::{QuadContent, SoundRequest, UiScript, WornDisplay};

/// The window's real neighbourhood, in the manifest's own order (options before the menu — the
/// game_menu_tests::harness_with idiom, minus the extras this file never needs).
fn harness() -> UiScript {
    harness_on(UiScript::new().unwrap())
}

/// Load the manifest slice onto a prepared script — split out so page tests can seed CVars
/// BEFORE the XML loads, the way the app does (ui_script::setup_script). The dropdown kit
/// rides along since 0992 (the dropdown rows inherit its capsule template), and GameTooltip
/// before it for the kit's TOOLTIP_DEFAULT_COLOR — the app's own order.
fn harness_on(mut s: UiScript) -> UiScript {
    s.set_screen_size(1024.0, 768.0);
    for file in [
        "Fonts.xml",
        "MoneyFrame.xml",
        "UiPanels.xml",
        "GameTooltip.xml",
        "UIDropDownMenu.xml",
        "ScrollTemplates.xml", // the Keybindings page's faux-scroll kit
        "KeyBindingsPage.xml", // the Keybindings body's templates + script (1008)
        "OptionsFrame.xml",
        "GameMenuFrame.xml",
    ] {
        let text = std::fs::read_to_string(
            std::path::Path::new(env!("CARGO_MANIFEST_DIR"))
                .join("assets/ui")
                .join(file),
        )
        .unwrap();
        let doc = benilla_ui::framexml::parse(&text).unwrap();
        let report = benilla_ui::loader::load(&s, &doc, &|_| None);
        assert!(
            report.errors.is_empty(),
            "{file}: loader errors: {:?}",
            report.errors
        );
        // The dialect announces DROPPED subtrees as warnings, not errors — for the new file,
        // a warning is a silently-missing piece of chrome, so it fails here.
        if file == "OptionsFrame.xml" {
            assert!(
                report.warnings.is_empty(),
                "{file}: loader warnings (dropped subtrees?): {:?}",
                report.warnings
            );
        }
    }
    assert!(s.errors().is_empty(), "script errors: {:?}", s.errors());
    s
}

/// The door in: the game menu's Options button (its ref OnClick + the explicit hide) swaps the
/// two native-center frames — menu down, options up holding the center slot — on the ref's own
/// igMainMenuOption kit.
#[test]
fn the_menu_options_button_swaps_the_menu_for_the_options_window() {
    let mut s = harness();
    s.run("ShowUIPanel(GameMenuFrame)").unwrap();
    let _ = s.take_sounds();

    s.run("GameMenuButtonOptions:Click()").unwrap();
    assert!(
        s.eval::<bool>("return OptionsFrame:IsVisible()").unwrap(),
        "the options window opened"
    );
    assert!(
        !s.eval::<bool>("return GameMenuFrame:IsVisible()").unwrap(),
        "…and the menu went away first"
    );
    assert!(
        s.eval::<bool>("return GetCenterFrame():GetName() == \"OptionsFrame\"")
            .unwrap(),
        "the window holds the native-center slot the menu vacated"
    );
    assert!(s
        .take_sounds()
        .contains(&SoundRequest::KitName("igMainMenuOption".into())));
    assert!(s.errors().is_empty(), "script errors: {:?}", s.errors());
}

/// Controls is the default page (the OnShow seat), and the page title is the selected row's own
/// label — including the one key whose label differs from it (ActionBars → "Action Bars").
#[test]
fn controls_is_the_default_category_and_the_title_reads_it() {
    let s = harness();
    s.run("ShowUIPanel(OptionsFrame)").unwrap();

    assert_eq!(
        s.eval::<String>("return OptionsFrame.selectedCategory")
            .unwrap(),
        "Controls"
    );
    assert_eq!(
        s.eval::<String>("return OptionsFrameContainerTitle:GetText()")
            .unwrap(),
        "Controls"
    );
    // The row labels are the era category tree's.
    assert_eq!(
        s.eval::<String>("return OptionsFrameCategoryListRowActionBars:GetText()")
            .unwrap(),
        "Action Bars"
    );
    assert!(s.errors().is_empty(), "script errors: {:?}", s.errors());
}

/// Clicking a category row moves the selection and the page title with it — and the selection
/// survives a close/reopen (the OnShow re-applies the last seat, not the default).
#[test]
fn clicking_a_row_moves_the_selection_and_the_page_title() {
    let s = harness();
    s.run("ShowUIPanel(OptionsFrame)").unwrap();

    s.run("OptionsFrameCategoryListRowGraphics:Click()")
        .unwrap();
    assert_eq!(
        s.eval::<String>("return OptionsFrame.selectedCategory")
            .unwrap(),
        "Graphics"
    );
    assert_eq!(
        s.eval::<String>("return OptionsFrameContainerTitle:GetText()")
            .unwrap(),
        "Graphics"
    );

    // Close and reopen: still Graphics, not Controls.
    s.run("HideUIPanel(OptionsFrame)").unwrap();
    s.run("ShowUIPanel(OptionsFrame)").unwrap();
    assert_eq!(
        s.eval::<String>("return OptionsFrameContainerTitle:GetText()")
            .unwrap(),
        "Graphics"
    );
    assert!(s.errors().is_empty(), "script errors: {:?}", s.errors());
}

/// The red Close hides the window on the igMainMenuClose kit, and the corner X does not EXIST
/// (0989's directed cut).
///
/// This test used to ride a rowless page here to watch Defaults stay disabled, and the stand-in
/// kept moving as the arc filled pages in — Controls until 0961, Interface until 1136, Social
/// (now Chat) until 1139. **There is no rowless category left**, which is the milestone rather than a gap;
/// the guard itself is pinned by `the_defaults_button_is_armed_by_rows_not_by_a_category` below.
#[test]
fn the_close_button_hides_the_window() {
    let mut s = harness();

    s.run("ShowUIPanel(OptionsFrame)").unwrap();
    let _ = s.take_sounds();
    s.run("OptionsFrameCloseButton:Click()").unwrap();
    assert!(!s.eval::<bool>("return OptionsFrame:IsVisible()").unwrap());
    assert!(s
        .take_sounds()
        .contains(&SoundRequest::KitName("igMainMenuClose".into())));

    // No corner X (0989's directed cut — the era HAS one; the red button and ESC are the
    // window's exits).
    assert!(s
        .eval::<bool>("return OptionsFrameClosePanelButton == nil")
        .unwrap());
    assert!(s.errors().is_empty(), "script errors: {:?}", s.errors());
}

/// The row wash (0984: the 1.14 OptionsListButtonTemplate mechanism, verbatim — ONE
/// UI-QuestLogTitleHighlight quad in ADD blend, two tints): the selected row's wash draws
/// additive in the LOCKED GOLD (1,1,0) at the era plate seat (187x21 — sized once in
/// OptionsCategoryRow_OnLoad); a moved selection reseats the single gold quad lower; and
/// hovering an UNSELECTED row lights the same texture in the steel-blue hover tint
/// (.196,.388,.8) while the locked gold stands — 1.14's LockHighlight guard.
#[test]
fn the_selected_row_wears_the_gold_wash_and_hover_runs_blue() {
    let mut s = harness();
    // Pin the window at scale 1 so row rects and the pointer share coordinates (the fit
    // clamp stays out of the way at 1024x768: both ratios sit above 1).
    s.run("ERA_WINDOW_SCALE = 1").unwrap();
    s.run("ShowUIPanel(OptionsFrame)").unwrap();

    // The plate seat: the era's 187x21, authored in the row OnLoad now that no
    // SetAtlas(name, true) sizes it.
    assert_eq!(
        s.eval::<f64>("return OptionsFrameCategoryListRowControlsBg:GetWidth()")
            .unwrap(),
        187.0
    );
    assert_eq!(
        s.eval::<f64>("return OptionsFrameCategoryListRowControlsBg:GetHeight()")
            .unwrap(),
        21.0
    );

    // Every visible category wash: rect + tint + blend.
    let washes = |s: &mut UiScript| -> Vec<(benilla_ui::layout::Rect, [f32; 4], bool)> {
        s.resolve();
        s.extract()
            .into_iter()
            .filter_map(|q| match &q.content {
                QuadContent::Texture {
                    path: Some(p),
                    color,
                    additive,
                    ..
                } if p.contains("UI-QuestLogTitleHighlight") => {
                    q.rect.map(|r| (r, color.unwrap_or([1.0; 4]), *additive))
                }
                _ => None,
            })
            .collect()
    };
    let gold =
        |c: &[f32; 4]| (c[0] - 1.0).abs() < 1e-3 && (c[1] - 1.0).abs() < 1e-3 && c[2].abs() < 1e-3;
    let blue = |c: &[f32; 4]| {
        (c[0] - 0.196).abs() < 1e-3 && (c[1] - 0.388).abs() < 1e-3 && (c[2] - 0.8).abs() < 1e-3
    };

    let before = washes(&mut s);
    assert_eq!(
        before.len(),
        1,
        "exactly one wash shows: the locked selection"
    );
    assert!(before[0].2, "the wash draws ADD — 1.14's alphaMode");
    assert!(gold(&before[0].1), "…in the locked gold: {:?}", before[0].1);

    s.run("OptionsFrameCategoryListRowAudio:Click()").unwrap();
    let after = washes(&mut s);
    assert_eq!(after.len(), 1, "the wash moved, not multiplied");
    assert!(gold(&after[0].1), "still the gold tint: {:?}", after[0].1);
    assert!(
        after[0].0.top < before[0].0.top,
        "Audio sits below Controls, so the wash reseats lower (top {} -> {})",
        before[0].0.top,
        after[0].0.top
    );

    // Hover the now-unselected Controls row: its wash lights BLUE beside Audio's gold.
    let (cx, cy) = {
        let l: f32 = s
            .eval("return OptionsFrameCategoryListRowControls:GetLeft()")
            .unwrap();
        let r: f32 = s
            .eval("return OptionsFrameCategoryListRowControls:GetRight()")
            .unwrap();
        let t: f32 = s
            .eval("return OptionsFrameCategoryListRowControls:GetTop()")
            .unwrap();
        let b: f32 = s
            .eval("return OptionsFrameCategoryListRowControls:GetBottom()")
            .unwrap();
        ((l + r) * 0.5, (t + b) * 0.5)
    };
    s.mouse_move(cx, cy);
    let hovered = washes(&mut s);
    assert_eq!(
        hovered.len(),
        2,
        "hover adds its wash beside the locked gold"
    );
    assert_eq!(hovered.iter().filter(|w| gold(&w.1)).count(), 1);
    assert_eq!(
        hovered.iter().filter(|w| blue(&w.1)).count(),
        1,
        "the hover tint is 1.14's steel-blue: {:?}",
        hovered.iter().map(|w| w.1).collect::<Vec<_>>()
    );

    // Leaving puts the hover wash away; the lock stays.
    s.mouse_move(5.0, 5.0);
    let left = washes(&mut s);
    assert_eq!(left.len(), 1);
    assert!(gold(&left[0].1));
    assert!(s.errors().is_empty(), "script errors: {:?}", s.errors());
}

/// The GROUND DIM (1476) — the plain black fill that turns 0.6 of veil into a page you can
/// read. Two laws here, both silently breakable by hand, and neither about the taste number:
/// the fill must draw **above** the backdrop's tiled ground (a region sorts after its frame's
/// own draw slot, which is the whole reason a region *can* dim it), and it must sit clear of
/// the rope's **ink** — the border's four edge slices are dead from texel 16 of 32 and the
/// corners' ink ends by 14 (decoded from `UI-DialogBox-Border`), so anything inset 14 or more
/// darkens the page without touching the frame. At the backdrop's own 11/12/12/11 bg insets it
/// would smear across the rope's inner half, which is exactly the mistake this pins.
#[test]
fn the_ground_dim_draws_over_the_tile_and_clear_of_the_rope() {
    let mut s = harness();
    s.run("ERA_WINDOW_SCALE = 1").unwrap();
    s.run("ShowUIPanel(OptionsFrame)").unwrap();
    s.resolve();

    let edge = |frame: &str, side: &str| -> f32 {
        s.eval(&format!("return {frame}:Get{side}()")).unwrap()
    };
    let (fl, fr, ft, fb) = (
        edge("OptionsFrame", "Left"),
        edge("OptionsFrame", "Right"),
        edge("OptionsFrame", "Top"),
        edge("OptionsFrame", "Bottom"),
    );
    let (dl, dr, dt, db) = (
        edge("OptionsFrameGroundDim", "Left"),
        edge("OptionsFrameGroundDim", "Right"),
        edge("OptionsFrameGroundDim", "Top"),
        edge("OptionsFrameGroundDim", "Bottom"),
    );
    for (name, inset) in [
        ("left", dl - fl),
        ("right", fr - dr),
        ("top", ft - dt),
        ("bottom", db - fb),
    ] {
        assert!(
            inset >= 14.0,
            "the dim must clear the rope's ink on the {name} — inset {inset}"
        );
    }

    // Draw order: `extract` returns ascending z, so a later index draws later. The dim has to
    // land after the tiled ground or it dims nothing.
    let quads = s.extract();
    let ground = quads
        .iter()
        .position(|q| match &q.content {
            QuadContent::Backdrop { path, .. } => path.contains("UI-DialogBox-Background"),
            _ => false,
        })
        .expect("the window still wears the 1.14 dialog ground");
    let dim = quads
        .iter()
        .position(|q| {
            let Some(r) = q.rect else { return false };
            matches!(
                &q.content,
                QuadContent::Texture { path: None, color: Some(c), .. }
                    if c[0] == 0.0 && c[1] == 0.0 && c[2] == 0.0 && c[3] > 0.0 && c[3] < 1.0
            ) && (r.left - dl).abs() < 0.5
                && (r.top - dt).abs() < 0.5
        })
        .expect("the black ground fill is drawn");
    assert!(
        dim > ground,
        "the dim draws over the tile (ground #{ground}, dim #{dim})"
    );
    assert!(s.errors().is_empty(), "script errors: {:?}", s.errors());
}

/// Search (0984: the era SettingsPanel mechanism transcribed): typing reflows the LIVE
/// matching rows under a clickable category head — a matched CHILD pulls its parent volume
/// row in above it (the era parentInitializer rule) — the title reads "Search Results" and
/// Defaults hides; clearing the box lands every row back on its authored XML chain exactly
/// (the one-layout-law pin) with the page view restored.
#[test]
fn search_reflows_live_rows_and_restores_the_page() {
    let mut s = harness_on(audio_harness());
    s.run("ShowUIPanel(OptionsFrame)").unwrap();
    s.run("OptionsFrameCategoryListRowAudio:Click()").unwrap();
    s.resolve();
    let authored_top: f32 = s
        .eval("return OptionsFrameContainerBodyAudioRowMaster:GetTop()")
        .unwrap();

    s.run("OptionsFrameSearchBox:SetText(\"music\")").unwrap();
    assert_eq!(
        s.eval::<String>("return OptionsFrameContainerTitle:GetText()")
            .unwrap(),
        "Search Results"
    );
    assert!(
        !s.eval::<bool>("return OptionsFrameContainerDefaults:IsVisible()")
            .unwrap(),
        "Defaults hides while the search holds the page (the era SetShown(not hasText))"
    );
    // One head — Audio's; the matches plus their pulled-in parent; nothing else.
    for (frame, shown) in [
        ("OptionsFrameContainerBodySearchHeadAudio", true),
        ("OptionsFrameContainerBodySearchHeadControls", false),
        ("OptionsFrameContainerBodySearchHeadGraphics", false),
        ("OptionsFrameContainerBodyAudioRowMusic", true),
        ("OptionsFrameContainerBodyAudioRowEnableMusic", true),
        ("OptionsFrameContainerBodyAudioRowMaster", true), // the parent, pulled in unmatched
        ("OptionsFrameContainerBodyAudioRowSound", false),
        ("OptionsFrameContainerBodyAudioRowEnableAll", false),
        ("OptionsFrameContainerBodyControlsRowAutoLoot", false),
        ("OptionsFrameContainerBodyGraphicsRowUiScale", false),
        ("OptionsFrameContainerBodyNoResults", false),
    ] {
        assert_eq!(
            s.eval::<bool>(&format!("return {frame}:IsVisible()"))
                .unwrap(),
            shown,
            "{frame} shown={shown}"
        );
    }
    // The chain reads head → parent → the two matches, downward.
    s.resolve();
    let tops: Vec<f32> = [
        "OptionsFrameContainerBodySearchHeadAudio",
        "OptionsFrameContainerBodyAudioRowMaster",
        "OptionsFrameContainerBodyAudioRowMusic",
        "OptionsFrameContainerBodyAudioRowEnableMusic",
    ]
    .iter()
    .map(|f| s.eval::<f32>(&format!("return {f}:GetTop()")).unwrap())
    .collect();
    assert!(
        tops[0] > tops[1] && tops[1] > tops[2] && tops[2] > tops[3],
        "head, parent, then the matches chain downward: {tops:?}"
    );
    // The reflowed row is LIVE: moving the music slider writes its CVar mid-search.
    let _ = s.take_cvar_changes();
    s.run("OptionsFrameContainerBodyAudioRowMusicControlSlider:SetValue(0.25)")
        .unwrap();
    assert_eq!(
        s.take_cvar_changes(),
        vec![("MusicVolume".to_string(), "0.25".to_string())]
    );

    // Clearing restores the page view and the authored chain EXACTLY.
    s.run("OptionsFrameSearchBox:SetText(\"\")").unwrap();
    assert_eq!(
        s.eval::<String>("return OptionsFrameContainerTitle:GetText()")
            .unwrap(),
        "Audio"
    );
    assert!(s
        .eval::<bool>("return OptionsFrameContainerDefaults:IsVisible()")
        .unwrap());
    s.resolve();
    let restored_top: f32 = s
        .eval("return OptionsFrameContainerBodyAudioRowMaster:GetTop()")
        .unwrap();
    assert!(
        (restored_top - authored_top).abs() < 0.01,
        "the restore law equals the authored XML chain ({restored_top} vs {authored_top})"
    );
    assert!(s.errors().is_empty(), "script errors: {:?}", s.errors());
}

/// The era's word scoring (Blizzard_Settings.lua MatchesSearchTags + the words list): the
/// WHOLE query is the first word, so a phrase match outscores its own tokens and chains
/// first within the group — "master volume" seats Master above the token-matched children.
#[test]
fn the_phrase_match_outranks_its_words() {
    let mut s = harness_on(audio_harness());
    s.run("ShowUIPanel(OptionsFrame)").unwrap();
    s.run("OptionsFrameSearchBox:SetText(\"master volume\")")
        .unwrap();
    s.resolve();
    let tops: Vec<f32> = [
        "OptionsFrameContainerBodyAudioRowMaster", // phrase hit, score 12
        "OptionsFrameContainerBodyAudioRowSound",  // "VOLUME" hits, score 5, page order
        "OptionsFrameContainerBodyAudioRowMusic",
        "OptionsFrameContainerBodyAudioRowAmbience",
    ]
    .iter()
    .map(|f| s.eval::<f32>(&format!("return {f}:GetTop()")).unwrap())
    .collect();
    assert!(
        tops[0] > tops[1] && tops[1] > tops[2] && tops[2] > tops[3],
        "phrase first, then the word matches in page order: {tops:?}"
    );
    assert!(s.errors().is_empty(), "script errors: {:?}", s.errors());
}

/// The era's search exits: clicking a results head (the era's jump — SelectCategory clears
/// the box) and a no-match query (the section-header "no results" line, nothing chained).
#[test]
fn a_head_click_ends_the_search_and_a_miss_shows_no_results() {
    let s = harness();
    s.run("ShowUIPanel(OptionsFrame)").unwrap();

    s.run("OptionsFrameSearchBox:SetText(\"volume\")").unwrap();
    s.run("OptionsFrameContainerBodySearchHeadAudio:Click()")
        .unwrap();
    assert_eq!(
        s.eval::<String>("return OptionsFrameSearchBox:GetText()")
            .unwrap(),
        "",
        "the head click cleared the search (the era SelectCategory law)"
    );
    assert_eq!(
        s.eval::<String>("return OptionsFrame.selectedCategory")
            .unwrap(),
        "Audio"
    );
    assert_eq!(
        s.eval::<String>("return OptionsFrameContainerTitle:GetText()")
            .unwrap(),
        "Audio"
    );
    assert!(s
        .eval::<bool>("return OptionsFrameContainerBodyAudio:IsVisible()")
        .unwrap());

    s.run("OptionsFrameSearchBox:SetText(\"flibbertigibbet\")")
        .unwrap();
    assert!(s
        .eval::<bool>("return OptionsFrameContainerBodyNoResults:IsVisible()")
        .unwrap());
    for head in ["Controls", "Audio", "Graphics"] {
        assert!(
            !s.eval::<bool>(&format!(
                "return OptionsFrameContainerBodySearchHead{head}:IsVisible()"
            ))
            .unwrap(),
            "no head on a miss"
        );
    }
    s.run("OptionsFrameSearchBox:SetText(\"\")").unwrap();
    assert!(!s
        .eval::<bool>("return OptionsFrameContainerBodyNoResults:IsVisible()")
        .unwrap());
    assert!(s.errors().is_empty(), "script errors: {:?}", s.errors());
}

/// The bar IS the control (0989: steppers cut by the director's call; the engine's
/// track-press law): a LeftButton press on the slider's track — off the thumb — seats the
/// thumb under the cursor (the value jumps, the CVar write queues), the SAME press keeps
/// dragging (0250 §5's capture began), and the stepper buttons no longer exist.
#[test]
fn a_track_press_seats_the_thumb_and_keeps_dragging() {
    let mut s = harness_on(audio_harness());
    s.set_cvar_host("MasterVolume", "0.1");
    s.run("ERA_WINDOW_SCALE = 1").unwrap(); // pointer and rects share coordinates
    s.run("ShowUIPanel(OptionsFrame)").unwrap();
    s.run("OptionsFrameCategoryListRowAudio:Click()").unwrap();
    let _ = s.take_cvar_changes();

    // The steppers are gone.
    for btn in ["Back", "Forward"] {
        assert!(s
            .eval::<bool>(&format!(
                "return OptionsFrameContainerBodyAudioRowMasterControl{btn} == nil"
            ))
            .unwrap());
    }

    let slider = "OptionsFrameContainerBodyAudioRowMasterControlSlider";
    s.resolve(); // seat the rects before reading them (the wash test's idiom)
    let (l, r, t, b) = (
        s.eval::<f32>(&format!("return {slider}:GetLeft()"))
            .unwrap(),
        s.eval::<f32>(&format!("return {slider}:GetRight()"))
            .unwrap(),
        s.eval::<f32>(&format!("return {slider}:GetTop()")).unwrap(),
        s.eval::<f32>(&format!("return {slider}:GetBottom()"))
            .unwrap(),
    );
    let cy = (t + b) * 0.5;
    // Press 1 unit inside the RIGHT end of the track — far from the 0.1-seated thumb. The
    // center-grab seat clamps the fraction to 1.0 there (the cursor sits inside the thumb's
    // half-width end zone), so the value lands exactly at the max.
    s.mouse_button(r - 1.0, cy, "LeftButton", true);
    assert!(
        s.eval::<bool>(&format!(
            "return math.abs({slider}:GetValue() - 1.0) < 0.0001"
        ))
        .unwrap(),
        "the press itself seats the thumb"
    );
    assert_eq!(
        s.take_cvar_changes(),
        vec![("MasterVolume".to_string(), "1".to_string())]
    );
    // Still held: the same gesture drags on. The slider's midpoint is exactly fraction 0.5
    // ((mid − thumb/2 − left) / (width − thumb)), on the 0.05 grid, so no snap correction.
    s.mouse_move((l + r) * 0.5, cy);
    assert!(
        s.eval::<bool>(&format!(
            "return math.abs({slider}:GetValue() - 0.5) < 0.0001"
        ))
        .unwrap(),
        "the capture began at the press — the drag follows without re-grabbing"
    );
    assert_eq!(
        s.take_cvar_changes(),
        vec![("MasterVolume".to_string(), "0.5".to_string())]
    );
    s.mouse_button((l + r) * 0.5, cy, "LeftButton", false);
    assert!(s.errors().is_empty(), "script errors: {:?}", s.errors());
}

/// The Audio harness: the real registered CVar set on the table before the XML loads, exactly
/// the app's boot order (register → seed → load → select).
fn audio_harness() -> UiScript {
    let mut s = UiScript::new().unwrap();
    s.register_cvars(crate::cvars::REGISTERED.iter().copied());
    s
}

/// The Combat page's harness (decision 1134): the **real** `CombatText.xml` loaded ahead of the
/// window, in the manifest's own order (it is file 59, OptionsFrame.xml file 281), so the rows
/// capture the same file-scope defaults and the same `applyFunc` they capture in the client —
/// nothing about the family is restated here. `UIParent.xml` comes first because CombatText's
/// strings anchor to it.
fn combat_harness() -> UiScript {
    let mut s = audio_harness();
    s.set_screen_size(1024.0, 768.0);
    load_definers(&s, &["UIParent.xml", "CombatText.xml"]);
    harness_on(s)
}

/// The files a saved-variable page's DEFINERS live in, loaded ahead of the window (see
/// `combat_harness`). Every page over the second store needs this: a row captures its default from
/// the global's own file-scope assignment at OnLoad, so that file has to have run first — which is
/// exactly the ordering the real manifest guarantees.
fn load_definers(s: &UiScript, files: &[&str]) {
    for file in files {
        let text = std::fs::read_to_string(
            std::path::Path::new(env!("CARGO_MANIFEST_DIR"))
                .join("assets/ui")
                .join(file),
        )
        .unwrap();
        let doc = benilla_ui::framexml::parse(&text).unwrap();
        let report = benilla_ui::loader::load(s, &doc, &|_| None);
        assert!(
            report.errors.is_empty(),
            "{file}: loader errors: {:?}",
            report.errors
        );
    }
}

/// The Interface page's harness (decision 1136), the same posture as `combat_harness` above: the
/// **real** definers ahead of the window, in the manifest's own order, so each row captures the
/// same file-scope value it captures in the client. `SHOW_NEWBIE_TIPS` rides in on `GameTooltip.xml`
/// which `harness_on` already loads; the two quest globals need their own windows —
/// `MerchantFrame.xml` for the coin helpers both quest files reuse and `ScrollTemplates.xml` for
/// the kit `QuestFrame.xml` inherits from (the same chain `quest_tests`/`questlog_tests` load).
/// `SHOW_BUFF_DURATIONS` arrives with the bar it re-anchors (1139), behind the two files
/// `buff_tests` loads ahead of it — `Cooldown.xml` (every button's child) and `ActionBar.xml`
/// (`BENILLA_FALLBACK_ICON`), themselves behind `UIParent.xml`. `TextStatusBar.xml` rides in
/// ahead of them for the Status Bar Text row's consumer — the XP bar's numerals (1140).
fn interface_harness() -> UiScript {
    let mut s = audio_harness();
    s.set_screen_size(1024.0, 768.0);
    load_definers(
        &s,
        &[
            "Fonts.xml",
            "MoneyFrame.xml",
            "UiPanels.xml",
            "UIParent.xml",
            // The target-of-target pair's definer (1576) and the three files ahead of it, all in
            // their manifest seats. The chain is a real load-ORDER requirement rather than
            // tidiness: `UnitFrames`' three menu hosts initialize into the dropdown kit at load
            // (`UIDropDownMenu_Initialize` is nil without it and the OnLoad raises), and the kit's
            // own backdrop reads `GameTooltip`'s TOOLTIP_DEFAULT_COLOR. `harness_on` loads two of
            // these again after these — re-running a UI file is what `/reload` does, and the
            // loader takes it.
            "GameTooltip.xml",
            "UIDropDownMenu.xml",
            "UnitPopup.xml",
            "TextStatusBar.xml",
            "UnitFrames.xml",
            "Cooldown.xml",
            "ActionBar.xml",
            "ScrollTemplates.xml",
            "BuffFrame.xml",
            "MerchantFrame.xml",
            "QuestFrame.xml",
            "QuestLogFrame.xml",
        ],
    );
    harness_on(s)
}

/// The Chat page's harness (decision 1589), the same posture as `combat_harness`: the **real**
/// `ChatFrame.xml` ahead of the window, so the *Remove Chat Hover Delay* row captures the same
/// file-scope `REMOVE_CHAT_DELAY = "0"` and the same `ChatFrame_ApplyMouseOverDelay` it captures in
/// the client. Its own chain is the manifest's: `UIParent.xml` for the managed bottom stack the
/// dock sits in, and `GameTooltip.xml` + `UIDropDownMenu.xml` because the tabs' options menus are
/// dropdown capsules and a tab click reaches `CloseDropDownMenus`.
fn chat_harness() -> UiScript {
    let mut s = audio_harness();
    s.set_screen_size(1024.0, 768.0);
    load_definers(
        &s,
        &[
            "Fonts.xml",
            "MoneyFrame.xml",
            "UiPanels.xml",
            "UIParent.xml",
            "GameTooltip.xml",
            "UIDropDownMenu.xml",
            "ChatFrame.xml",
        ],
    );
    harness_on(s)
}

/// The Action Bars page's harness (1136's lock row, 1500's five switches): `ActionBar.xml` declares
/// `LOCK_ACTIONBAR` and `MultiBars.xml` the four `SHOW_MULTI_ACTIONBAR_*` globals plus
/// `ALWAYS_SHOW_MULTIBARS` (whose file-scope "0" IS the row's registered default), and both need
/// `UIParent.xml` (the managed bottom stack the bars move) and `Cooldown.xml`
/// (`CooldownFrame_SetTimer`, every button's child) ahead of them — the manifest's own order.
fn actionbars_harness() -> UiScript {
    let mut s = audio_harness();
    s.set_screen_size(1024.0, 768.0);
    load_definers(
        &s,
        &[
            "Fonts.xml",
            "UIParent.xml",
            "Cooldown.xml",
            "ActionBar.xml",
            "MultiBars.xml",
        ],
    );
    harness_on(s)
}

/// Selecting Audio shows the page body, arms Defaults, and every row reads the CVar table:
/// sliders take the stored value with the era rounded-percent readout, checkboxes take the flag.
/// Leaving the page hides it and puts Defaults back to sleep.
#[test]
fn the_audio_page_reads_the_cvar_table_on_select() {
    let mut s = audio_harness();
    s.set_cvar_host("MusicVolume", "0.7");
    s.set_cvar_host("EnableMusic", "0");
    let s = harness_on(s);
    s.run("ShowUIPanel(OptionsFrame)").unwrap();
    s.run("OptionsFrameCategoryListRowAudio:Click()").unwrap();

    assert!(s
        .eval::<bool>("return OptionsFrameContainerBodyAudio:IsVisible()")
        .unwrap());
    assert!(s
        .eval::<bool>("return OptionsFrameContainerDefaults:IsEnabled()")
        .unwrap());
    // The music slider holds the stored 0.7 (f32 wobble tolerated), readout "70%".
    assert!(s
        .eval::<bool>(
            "return math.abs(OptionsFrameContainerBodyAudioRowMusicControlSlider:GetValue() - 0.7) < 0.0001"
        )
        .unwrap());
    assert_eq!(
        s.eval::<String>("return OptionsFrameContainerBodyAudioRowMusicControlValue:GetText()")
            .unwrap(),
        "70%"
    );
    // Checkboxes: EnableMusic off, the master (default "1") on.
    assert!(!s
        .eval::<bool>("return OptionsFrameContainerBodyAudioRowEnableMusicCheck:GetChecked()")
        .unwrap());
    assert!(s
        .eval::<bool>("return OptionsFrameContainerBodyAudioRowEnableAllCheck:GetChecked()")
        .unwrap());

    // Off to another page: the Audio body goes away with the selection (the swap is what the
    // page loop does, and it is the reason a stale row can never be read from the wrong page).
    s.run("OptionsFrameCategoryListRowChat:Click()").unwrap();
    assert!(!s
        .eval::<bool>("return OptionsFrameContainerBodyAudio:IsVisible()")
        .unwrap());
    assert!(s
        .eval::<bool>("return OptionsFrameContainerBodyChat:IsVisible()")
        .unwrap());
    assert!(s.errors().is_empty(), "script errors: {:?}", s.errors());
}

/// A user move snaps to the era 5% grid (obeyStepOnDrag transcribed) and writes the CVar as a
/// clean short string — the change queue carries what config.toml will store. A refresh write
/// (the page reading the table) queues nothing.
#[test]
fn a_slider_move_snaps_and_writes_the_cvar() {
    let mut s = harness_on(audio_harness());
    s.run("ShowUIPanel(OptionsFrame)").unwrap();
    s.run("OptionsFrameCategoryListRowAudio:Click()").unwrap();
    assert!(
        s.take_cvar_changes().is_empty(),
        "reading the table on select must not write it back"
    );

    // An off-grid move (what a drag delivers) snaps to 0.45 and queues exactly that.
    s.run("OptionsFrameContainerBodyAudioRowMasterControlSlider:SetValue(0.43)")
        .unwrap();
    assert!(s
        .eval::<bool>(
            "return math.abs(OptionsFrameContainerBodyAudioRowMasterControlSlider:GetValue() - 0.45) < 0.0001"
        )
        .unwrap());
    assert_eq!(
        s.eval::<String>("return OptionsFrameContainerBodyAudioRowMasterControlValue:GetText()")
            .unwrap(),
        "45%"
    );
    assert_eq!(
        s.take_cvar_changes(),
        vec![("MasterVolume".to_string(), "0.45".to_string())]
    );

    assert!(s.errors().is_empty(), "script errors: {:?}", s.errors());
}

/// The checkbox rows write their flag CVar on the 1.12 panel's own (quirky) click kits, and the
/// 1.12 dependency holds: Enable All Sound off greys exactly the Enable Ambience row.
#[test]
fn the_checkbox_rows_write_flags_and_the_master_greys_ambience() {
    let mut s = harness_on(audio_harness());
    s.run("ShowUIPanel(OptionsFrame)").unwrap();
    s.run("OptionsFrameCategoryListRowAudio:Click()").unwrap();
    let _ = s.take_cvar_changes();
    let _ = s.take_sounds();

    // Uncheck the master: flag "0" queued, ambience greyed, music left alive (the 1.12 quirk),
    // and the just-UNchecked box plays the CheckBoxOn kit (SoundOptionsFrame.lua verbatim).
    s.run("OptionsFrameContainerBodyAudioRowEnableAllCheck:Click()")
        .unwrap();
    assert_eq!(
        s.take_cvar_changes(),
        vec![("MasterSoundEffects".to_string(), "0".to_string())]
    );
    assert!(!s
        .eval::<bool>("return OptionsFrameContainerBodyAudioRowEnableAmbienceCheck:IsEnabled()")
        .unwrap());
    assert!(s
        .eval::<bool>("return OptionsFrameContainerBodyAudioRowEnableMusicCheck:IsEnabled()")
        .unwrap());
    assert!(s
        .take_sounds()
        .contains(&SoundRequest::KitName("igMainMenuOptionCheckBoxOn".into())));

    // Re-check: flag "1", ambience live again.
    s.run("OptionsFrameContainerBodyAudioRowEnableAllCheck:Click()")
        .unwrap();
    assert_eq!(
        s.take_cvar_changes(),
        vec![("MasterSoundEffects".to_string(), "1".to_string())]
    );
    assert!(s
        .eval::<bool>("return OptionsFrameContainerBodyAudioRowEnableAmbienceCheck:IsEnabled()")
        .unwrap());
    assert!(s.errors().is_empty(), "script errors: {:?}", s.errors());
}

/// Defaults walks every Audio row's CVar back to its registered default and the rows follow —
/// the era per-page reset, on the one page with rows.
#[test]
fn defaults_resets_the_audio_page_to_registered_defaults() {
    let mut s = audio_harness();
    s.set_cvar_host("MusicVolume", "0.9");
    s.set_cvar_host("EnableMusic", "0");
    let mut s = harness_on(s);
    s.run("ShowUIPanel(OptionsFrame)").unwrap();
    s.run("OptionsFrameCategoryListRowAudio:Click()").unwrap();
    let _ = s.take_cvar_changes();

    s.run("OptionsFrameContainerDefaults:Click()").unwrap();
    let changes = s.take_cvar_changes();
    assert!(
        changes.contains(&("MusicVolume".to_string(), "0.4".to_string())),
        "music back to its 1.12 registration default: {changes:?}"
    );
    assert!(
        changes.contains(&("EnableMusic".to_string(), "1".to_string())),
        "the flag back on: {changes:?}"
    );
    // Only the MOVED values queue — the rows already at default write nothing.
    assert_eq!(changes.len(), 2, "{changes:?}");
    assert!(s
        .eval::<bool>("return OptionsFrameContainerBodyAudioRowEnableMusicCheck:GetChecked()")
        .unwrap());
    assert_eq!(
        s.eval::<String>("return OptionsFrameContainerBodyAudioRowMusicControlValue:GetText()")
            .unwrap(),
        "40%"
    );
    assert!(s.errors().is_empty(), "script errors: {:?}", s.errors());
}

/// Selecting Graphics shows ITS page body (0959) with both 1.12 sliders reading the table:
/// uiScale on the 0.64..1.0 panel range with the percent readout, farclip (Terrain Distance —
/// retired 0961, back 1513) on 177..777 with the raw-yards readout. The swap works both ways —
/// Audio's body takes over when clicked.
#[test]
fn the_graphics_page_reads_the_cvar_table_on_select() {
    let mut s = audio_harness();
    s.set_cvar_host("uiScale", "0.8");
    s.set_cvar_host("farclip", "297");
    let s = harness_on(s);
    s.run("ShowUIPanel(OptionsFrame)").unwrap();
    s.run("OptionsFrameCategoryListRowGraphics:Click()")
        .unwrap();

    assert!(s
        .eval::<bool>("return OptionsFrameContainerBodyGraphics:IsVisible()")
        .unwrap());
    assert!(s
        .eval::<bool>("return OptionsFrameContainerDefaults:IsEnabled()")
        .unwrap());
    assert!(s
        .eval::<bool>(
            "return math.abs(OptionsFrameContainerBodyGraphicsRowUiScaleControlSlider:GetValue() - 0.8) < 0.0001"
        )
        .unwrap());
    assert_eq!(
        s.eval::<String>(
            "return OptionsFrameContainerBodyGraphicsRowUiScaleControlValue:GetText()"
        )
        .unwrap(),
        "80%"
    );
    assert!(s
        .eval::<bool>(
            "return math.abs(OptionsFrameContainerBodyGraphicsRowFarclipControlSlider:GetValue() - 297) < 0.001"
        )
        .unwrap());
    assert_eq!(
        s.eval::<String>(
            "return OptionsFrameContainerBodyGraphicsRowFarclipControlValue:GetText()"
        )
        .unwrap(),
        "297"
    );
    // The labels are the 1.12 GlobalStrings' own.
    assert_eq!(
        s.eval::<String>("return OptionsFrameContainerBodyGraphicsRowUiScaleLabel:GetText()")
            .unwrap(),
        "UI Scale"
    );
    assert_eq!(
        s.eval::<String>("return OptionsFrameContainerBodyGraphicsRowFarclipLabel:GetText()")
            .unwrap(),
        "Terrain Distance"
    );

    // The swap, the other way: Audio in, Graphics out.
    s.run("OptionsFrameCategoryListRowAudio:Click()").unwrap();
    assert!(!s
        .eval::<bool>("return OptionsFrameContainerBodyGraphics:IsVisible()")
        .unwrap());
    assert!(s
        .eval::<bool>("return OptionsFrameContainerBodyAudio:IsVisible()")
        .unwrap());
    assert!(s.errors().is_empty(), "script errors: {:?}", s.errors());
}

/// **Vertical Sync** (1394) — the Graphics page's third row, and the first option in this window
/// that reaches the *window* rather than a gameplay or UI knob. It is 1.12's own Video Options
/// checkbox 5 (`gxVSync`), which lived on the perf HUD as a dev checkbox until it turned out to be
/// unreachable in a player build (the HUD is `#[cfg(feature = "dev")]`) and to be a setting rather
/// than an instrument in the first place.
///
/// The row is deliberately **not** deferred, unlike the UI Scale slider above it: the reference's
/// row carries `gxRestart = 1` because its device could not swap the presentation interval live,
/// and wgpu can — so the click commits, like every other checkbox here.
#[test]
fn the_vertical_sync_row_reads_and_writes_the_present_mode_cvar() {
    let mut s = audio_harness();
    s.set_cvar_host("gxVSync", "0");
    let mut s = harness_on(s);
    s.run("ShowUIPanel(OptionsFrame)").unwrap();
    s.run("OptionsFrameCategoryListRowGraphics:Click()")
        .unwrap();

    // Read from the table, not from a restated default: the harness seeded it off.
    assert!(!s
        .eval::<bool>("return OptionsFrameContainerBodyGraphicsRowVerticalSyncCheck:GetChecked()")
        .unwrap());
    assert_eq!(
        s.eval::<String>("return OptionsFrameContainerBodyGraphicsRowVerticalSyncLabel:GetText()")
            .unwrap(),
        "Vertical Sync"
    );
    let _ = s.take_cvar_changes();

    // A click commits immediately — nothing stages it behind Apply.
    s.run("OptionsFrameContainerBodyGraphicsRowVerticalSyncCheck:Click()")
        .unwrap();
    assert_eq!(
        s.take_cvar_changes(),
        vec![("gxVSync".to_string(), "1".to_string())],
        "the checkbox writes the cvar on click, not on Apply"
    );

    // Defaults walks it back to the registered "1" — which `cvars::tests` welds to
    // `VideoConfig::default()`, and `video::tests` welds in turn to the window's boot mode.
    s.run("OptionsFrameContainerBodyGraphicsRowVerticalSyncCheck:Click()")
        .unwrap();
    let _ = s.take_cvar_changes();
    s.run("OptionsFrameContainerDefaults:Click()").unwrap();
    assert!(s
        .eval::<bool>("return OptionsFrameContainerBodyGraphicsRowVerticalSyncCheck:GetChecked()")
        .unwrap());
    assert!(s.errors().is_empty(), "script errors: {:?}", s.errors());
}

/// The dropdown row (0992, the first): the capsule reads the CVar on select (text from the
/// row's own entries), the capsule button opens the shared list at the OWNER's effective scale
/// (the kit's 0992 uiScale correction — the window rides SetScale) with the current value's
/// entry checked, and an entry click writes the CVar, repaints the capsule, and closes the
/// list on the kit's own law.
#[test]
fn the_world_detail_dropdown_writes_the_cvar_and_the_capsule_follows() {
    let mut s = audio_harness();
    s.set_cvar_host("WorldDetail", "0");
    let mut s = harness_on(s);
    s.run("ShowUIPanel(OptionsFrame)").unwrap();
    s.run("OptionsFrameCategoryListRowGraphics:Click()")
        .unwrap();
    assert_eq!(
        s.eval::<String>(
            "return OptionsFrameContainerBodyGraphicsRowWorldDetailDropdownText:GetText()"
        )
        .unwrap(),
        "Low"
    );
    assert_eq!(
        s.eval::<String>("return OptionsFrameContainerBodyGraphicsRowWorldDetailLabel:GetText()")
            .unwrap(),
        "Environment Detail"
    );
    assert!(
        s.take_cvar_changes().is_empty(),
        "reading the table on select must not write it back"
    );

    // The capsule button opens the list: three entries, the stored value's row checked, and
    // the shared list wearing the window's effective scale (0.78 era scale, checkFit capped).
    s.run("OptionsFrameContainerBodyGraphicsRowWorldDetailDropdownButton:Click()")
        .unwrap();
    assert!(s.eval::<bool>("return DropDownList1:IsVisible()").unwrap());
    assert_eq!(
        s.eval::<f64>("return DropDownList1.numButtons").unwrap(),
        3.0
    );
    assert!(s
        .eval::<bool>("return DropDownList1Button1Check:IsVisible()")
        .unwrap());
    assert!(!s
        .eval::<bool>("return DropDownList1Button3Check:IsVisible()")
        .unwrap());
    assert!(s
        .eval::<bool>(
            "return math.abs(DropDownList1:GetScale() - OptionsFrame:GetScale()) < 0.0001"
        )
        .unwrap());

    // Clicking High: the write queues, the capsule repaints, the list closes.
    s.run("DropDownList1Button3:Click()").unwrap();
    assert_eq!(
        s.take_cvar_changes(),
        vec![("WorldDetail".to_string(), "2".to_string())]
    );
    assert_eq!(
        s.eval::<String>(
            "return OptionsFrameContainerBodyGraphicsRowWorldDetailDropdownText:GetText()"
        )
        .unwrap(),
        "High"
    );
    assert!(!s.eval::<bool>("return DropDownList1:IsVisible()").unwrap());

    // An off-grid value (an env A/B: the hermetic capture's clutter-off session seeds "-1")
    // displays the NEAREST stop — 0959's out-of-range law — and writes nothing back.
    s.set_cvar_host("WorldDetail", "-1");
    s.run("OptionsFrameCategoryListRowAudio:Click(); OptionsFrameCategoryListRowGraphics:Click()")
        .unwrap();
    assert_eq!(
        s.eval::<String>(
            "return OptionsFrameContainerBodyGraphicsRowWorldDetailDropdownText:GetText()"
        )
        .unwrap(),
        "Low"
    );
    assert!(
        s.take_cvar_changes().is_empty(),
        "the nearest-stop display must not write back"
    );
    assert!(s.errors().is_empty(), "script errors: {:?}", s.errors());
}

/// The Graphics page's **Multisampling** row (decision 1631): its stops are enumerated from the
/// DEVICE, not a fixed ladder, and picking one writes the latched `gxMultisample`.
///
/// The device list is seeded Apple-shaped — 1x/2x/4x and no 8x — because that is what this
/// project's own machine reports, and because a fixed ladder offering 8x there is precisely the
/// crash 1631 exists to prevent. A machine with 8x would show four rows off the same code.
#[test]
fn the_multisampling_row_offers_exactly_what_the_device_supports() {
    // No explicit `register_cvars` here: `audio_harness` registers `cvars::REGISTERED` whole, and
    // the three multisample rows live in it. That is deliberate — if they are ever dropped from
    // the registry this test fails rather than papering over it with its own registration.
    let mut s = audio_harness();
    s.set_multisample_formats(vec![
        benilla_ui::script::MultisampleFormat {
            color_bits: 32,
            depth_bits: 32,
            samples: 1,
        },
        benilla_ui::script::MultisampleFormat {
            color_bits: 32,
            depth_bits: 32,
            samples: 2,
        },
        benilla_ui::script::MultisampleFormat {
            color_bits: 32,
            depth_bits: 32,
            samples: 4,
        },
    ]);
    let mut s = harness_on(s);
    s.run("ShowUIPanel(OptionsFrame)").unwrap();
    s.run("OptionsFrameCategoryListRowGraphics:Click()")
        .unwrap();

    assert_eq!(
        s.eval::<String>("return OptionsFrameContainerBodyGraphicsRowMultisampleLabel:GetText()")
            .unwrap(),
        "Multisampling",
        "the reference's own MULTISAMPLE global"
    );
    // "1" is the registered default and means NO multisampling, so the first stop reads "Off"
    // rather than "1x" (1635). The label carries the noun; the capsule carries the value.
    assert_eq!(
        s.eval::<String>(
            "return OptionsFrameContainerBodyGraphicsRowMultisampleDropdownText:GetText()"
        )
        .unwrap(),
        "Off",
        "1 is the encoding of NO multisampling, not one sample of it"
    );
    assert!(
        s.take_cvar_changes().is_empty(),
        "reading the table on select must not write it back"
    );

    // Three stops, because the device offered three. This is the assertion that would fail if the
    // row ever went back to a hardcoded ladder.
    s.run("OptionsFrameContainerBodyGraphicsRowMultisampleDropdownButton:Click()")
        .unwrap();
    assert_eq!(
        s.eval::<f64>("return DropDownList1.numButtons").unwrap(),
        3.0
    );
    assert_eq!(
        s.eval::<String>("return DropDownList1Button3:GetText()")
            .unwrap(),
        "4x"
    );

    // Picking 4x writes the CVar — live and persisted, even though the picture waits for the next
    // launch (the 1629 latch; the camera takes its sample count at spawn).
    s.run("DropDownList1Button3:Click()").unwrap();
    assert_eq!(
        s.take_cvar_changes(),
        vec![("gxMultisample".to_string(), "4".to_string())]
    );
    assert_eq!(
        s.eval::<String>(
            "return OptionsFrameContainerBodyGraphicsRowMultisampleDropdownText:GetText()"
        )
        .unwrap(),
        "4x"
    );
    assert!(s.errors().is_empty(), "script errors: {:?}", s.errors());
}

/// The Nameplates page (0992 — live at last): the three 1.12 UnitName* checkbox rows read the
/// table on select and write their flags on the interface panel's own click kit (checked →
/// CheckBoxOn; these rows carry no soundQuirk).
#[test]
fn the_nameplates_page_toggles_the_unit_name_cvars() {
    let mut s = harness_on(audio_harness());
    s.run("ShowUIPanel(OptionsFrame)").unwrap();
    s.run("OptionsFrameCategoryListRowNameplates:Click()")
        .unwrap();
    assert!(s
        .eval::<bool>("return OptionsFrameContainerBodyNameplates:IsVisible()")
        .unwrap());
    assert!(s
        .eval::<bool>("return OptionsFrameContainerDefaults:IsEnabled()")
        .unwrap());
    // The plate pair leads the page and rides `VPlateMode::default()`: enemy on (the 0167 boot
    // divergence), friendly off (faithful, 0599).
    assert!(
        s.eval::<bool>(
            "return OptionsFrameContainerBodyNameplatesRowEnemyPlatesCheck:GetChecked()"
        )
        .unwrap(),
        "Enemy Name Plates defaults checked"
    );
    assert!(
        !s.eval::<bool>(
            "return OptionsFrameContainerBodyNameplatesRowFriendlyPlatesCheck:GetChecked()"
        )
        .unwrap(),
        "Friendly Name Plates defaults unchecked"
    );
    // All three name rows ride their registered "1" defaults.
    for row in ["RowPlayerNames", "RowNpcNames", "RowOwnName"] {
        assert!(
            s.eval::<bool>(&format!(
                "return OptionsFrameContainerBodyNameplates{row}Check:GetChecked()"
            ))
            .unwrap(),
            "{row} defaults checked"
        );
    }
    let _ = s.take_sounds();

    // The friendly plates row writes the bit the V/Shift-V pair writes — the same CVar, so the
    // window and the keys can never disagree about what is on.
    s.run("OptionsFrameContainerBodyNameplatesRowFriendlyPlatesCheck:Click()")
        .unwrap();
    assert_eq!(
        s.take_cvar_changes(),
        vec![(crate::vplates::CVAR_FRIENDS.to_string(), "1".to_string())]
    );
    s.run("OptionsFrameContainerBodyNameplatesRowEnemyPlatesCheck:Click()")
        .unwrap();
    assert_eq!(
        s.take_cvar_changes(),
        vec![(crate::vplates::CVAR_ENEMIES.to_string(), "0".to_string())]
    );
    let _ = s.take_sounds();

    // Unchecking NPC Names queues the flag off and plays the OFF kit (no quirk here — the
    // 1.12 interface panel's PlayClickSound mapping, not the sound panel's inverted one).
    s.run("OptionsFrameContainerBodyNameplatesRowNpcNamesCheck:Click()")
        .unwrap();
    assert_eq!(
        s.take_cvar_changes(),
        vec![("UnitNameNPC".to_string(), "0".to_string())]
    );
    assert!(s
        .take_sounds()
        .contains(&SoundRequest::KitName("igMainMenuOptionCheckBoxOff".into())));
    s.run("OptionsFrameContainerBodyNameplatesRowNpcNamesCheck:Click()")
        .unwrap();
    assert_eq!(
        s.take_cvar_changes(),
        vec![("UnitNameNPC".to_string(), "1".to_string())]
    );
    assert!(s.errors().is_empty(), "script errors: {:?}", s.errors());
}

/// The uiScale row DEFERS (0961, era CommitFlag.Apply transcribed): moves snap to the 1.12
/// 0.01 grid and update the readout, but the CVar does not move — the Apply button appears
/// instead, commits the pending value on click, and disappears. Dragging back onto the
/// committed value clears the pending without a commit (era's IsModified).
#[test]
fn the_ui_scale_slider_defers_to_the_apply_button() {
    let mut s = harness_on(audio_harness());
    s.run("ShowUIPanel(OptionsFrame)").unwrap();
    s.run("OptionsFrameCategoryListRowGraphics:Click()")
        .unwrap();
    assert!(
        s.take_cvar_changes().is_empty(),
        "reading the table on select must not write it back"
    );
    assert!(
        !s.eval::<bool>("return OptionsFrameApplyButton:IsVisible()")
            .unwrap(),
        "no pending edit, no Apply button"
    );

    // Off-grid 0.787 snaps to 0.79 and the readout follows — but NOTHING queues; the Apply
    // button exists now (era shows and enables it together).
    s.run("OptionsFrameContainerBodyGraphicsRowUiScaleControlSlider:SetValue(0.787)")
        .unwrap();
    assert_eq!(
        s.eval::<String>(
            "return OptionsFrameContainerBodyGraphicsRowUiScaleControlValue:GetText()"
        )
        .unwrap(),
        "79%"
    );
    assert!(
        s.take_cvar_changes().is_empty(),
        "a deferred row must not write the CVar on the move"
    );
    assert!(s
        .eval::<bool>("return OptionsFrameApplyButton:IsVisible()")
        .unwrap());
    assert!(s
        .eval::<bool>("return OptionsFrameApplyButton:IsEnabled()")
        .unwrap());

    // A second move re-stages the pending value — still nothing queues (0989: the steppers
    // are gone; a drag's SetValue is the remaining move).
    s.run("OptionsFrameContainerBodyGraphicsRowUiScaleControlSlider:SetValue(0.8)")
        .unwrap();
    assert!(s.take_cvar_changes().is_empty());

    // Apply commits the LAST pending value, once, and the button goes away.
    s.run("OptionsFrameApplyButton:Click()").unwrap();
    assert_eq!(
        s.take_cvar_changes(),
        vec![("uiScale".to_string(), "0.8".to_string())]
    );
    assert!(!s
        .eval::<bool>("return OptionsFrameApplyButton:IsVisible()")
        .unwrap());

    // A move away arms Apply; dragging back onto the committed value disarms it.
    s.run("OptionsFrameContainerBodyGraphicsRowUiScaleControlSlider:SetValue(0.79)")
        .unwrap();
    assert!(s
        .eval::<bool>("return OptionsFrameApplyButton:IsVisible()")
        .unwrap());
    s.run("OptionsFrameContainerBodyGraphicsRowUiScaleControlSlider:SetValue(0.8)")
        .unwrap();
    assert!(!s
        .eval::<bool>("return OptionsFrameApplyButton:IsVisible()")
        .unwrap());
    assert!(
        s.take_cvar_changes().is_empty(),
        "arming and disarming never touched the CVar"
    );
    assert!(s.errors().is_empty(), "script errors: {:?}", s.errors());
}

/// Pending edits are PANEL-wide like era's modified table: they survive a category switch
/// (the row redisplays the pending value on return, era's GetValue-returns-pending) and die
/// only when the window hides — the reopened window reads the committed truth.
#[test]
fn a_pending_ui_scale_survives_the_page_switch_and_dies_on_hide() {
    let mut s = harness_on(audio_harness());
    s.run("ShowUIPanel(OptionsFrame)").unwrap();
    s.run("OptionsFrameCategoryListRowGraphics:Click()")
        .unwrap();
    s.run("OptionsFrameContainerBodyGraphicsRowUiScaleControlSlider:SetValue(0.7)")
        .unwrap();
    let _ = s.take_cvar_changes();

    // Off to Audio: the Apply button stays (the pending edit is not page-scoped)…
    s.run("OptionsFrameCategoryListRowAudio:Click()").unwrap();
    assert!(s
        .eval::<bool>("return OptionsFrameApplyButton:IsVisible()")
        .unwrap());
    // …and back: the slider shows the PENDING value, not the committed one.
    s.run("OptionsFrameCategoryListRowGraphics:Click()")
        .unwrap();
    assert_eq!(
        s.eval::<String>(
            "return OptionsFrameContainerBodyGraphicsRowUiScaleControlValue:GetText()"
        )
        .unwrap(),
        "70%"
    );

    // Hide discards (the era confirm dialog is cut): the reopened window reads the truth.
    s.run("HideUIPanel(OptionsFrame)").unwrap();
    s.run("ShowUIPanel(OptionsFrame)").unwrap();
    s.run("OptionsFrameCategoryListRowGraphics:Click()")
        .unwrap();
    assert_eq!(
        s.eval::<String>(
            "return OptionsFrameContainerBodyGraphicsRowUiScaleControlValue:GetText()"
        )
        .unwrap(),
        "90%"
    );
    assert!(!s
        .eval::<bool>("return OptionsFrameApplyButton:IsVisible()")
        .unwrap());
    assert!(
        s.take_cvar_changes().is_empty(),
        "the whole pending lifecycle never wrote the CVar"
    );
    assert!(s.errors().is_empty(), "script errors: {:?}", s.errors());
}

/// The Terrain Distance slider (1513) is a LIVE row, unlike uiScale: a move snaps to the 1.12
/// panel grid — 177+n·60, ANCHORED AT THE MINIMUM, so 300 lands on 297, not the multiple-of-60
/// 300 — writes the CVar on the move as a clean short string, and raises no Apply button. The
/// write is what moves the far-clip wall and the residency window together.
#[test]
fn the_terrain_distance_slider_snaps_to_the_1_12_grid_and_writes_live() {
    let mut s = harness_on(audio_harness());
    s.run("ShowUIPanel(OptionsFrame)").unwrap();
    s.run("OptionsFrameCategoryListRowGraphics:Click()")
        .unwrap();
    assert!(
        s.take_cvar_changes().is_empty(),
        "reading the table on select must not write it back"
    );

    s.run("OptionsFrameContainerBodyGraphicsRowFarclipControlSlider:SetValue(300)")
        .unwrap();
    assert!(s
        .eval::<bool>(
            "return math.abs(OptionsFrameContainerBodyGraphicsRowFarclipControlSlider:GetValue() - 297) < 0.001"
        )
        .unwrap());
    assert_eq!(
        s.eval::<String>(
            "return OptionsFrameContainerBodyGraphicsRowFarclipControlValue:GetText()"
        )
        .unwrap(),
        "297"
    );
    assert_eq!(
        s.take_cvar_changes(),
        vec![("farclip".to_string(), "297".to_string())]
    );
    assert!(
        !s.eval::<bool>("return OptionsFrameApplyButton:IsVisible()")
            .unwrap(),
        "a live row stages nothing"
    );
    assert!(s.errors().is_empty(), "script errors: {:?}", s.errors());
}

/// Defaults on the Graphics page: uiScale back to its registered default (0.9) and farclip to
/// its (350), the rows following, ONLY the moved values queuing — and a pending uiScale edit
/// dies with it (the default write supersedes what Apply would have committed).
#[test]
fn defaults_resets_the_graphics_page_to_registered_defaults() {
    let mut s = audio_harness();
    s.set_cvar_host("uiScale", "0.8");
    s.set_cvar_host("farclip", "297");
    let mut s = harness_on(s);
    s.run("ShowUIPanel(OptionsFrame)").unwrap();
    s.run("OptionsFrameCategoryListRowGraphics:Click()")
        .unwrap();
    // Stage a pending edit too — Defaults must kill it, not commit it.
    s.run("OptionsFrameContainerBodyGraphicsRowUiScaleControlSlider:SetValue(0.7)")
        .unwrap();
    let _ = s.take_cvar_changes();

    s.run("OptionsFrameContainerDefaults:Click()").unwrap();
    let changes = s.take_cvar_changes();
    assert!(
        changes.contains(&("uiScale".to_string(), "0.9".to_string())),
        "{changes:?}"
    );
    assert!(
        changes.contains(&("farclip".to_string(), "350".to_string())),
        "{changes:?}"
    );
    assert_eq!(
        changes.len(),
        2,
        "only the default writes queue — never the dead pending: {changes:?}"
    );
    assert_eq!(
        s.eval::<String>(
            "return OptionsFrameContainerBodyGraphicsRowFarclipControlValue:GetText()"
        )
        .unwrap(),
        "350"
    );
    assert_eq!(
        s.eval::<String>(
            "return OptionsFrameContainerBodyGraphicsRowUiScaleControlValue:GetText()"
        )
        .unwrap(),
        "90%"
    );
    assert!(!s
        .eval::<bool>("return OptionsFrameApplyButton:IsVisible()")
        .unwrap());
    assert!(s.errors().is_empty(), "script errors: {:?}", s.errors());
}

/// Controls is the DEFAULT page and has rows since 0961: opening the window lands on it with
/// Defaults armed, and the rows read the table — Sticky Targeting INVERTED (checked when
/// `deselectOnClick` is "0", the 1.12 interface panel's own arm), the plain flags direct.
#[test]
fn the_controls_page_reads_flags_with_the_sticky_inversion() {
    let mut s = audio_harness();
    s.set_cvar_host("deselectOnClick", "0");
    s.set_cvar_host("autoLootDefault", "1");
    let s = harness_on(s);
    s.run("ShowUIPanel(OptionsFrame)").unwrap();

    assert!(s
        .eval::<bool>("return OptionsFrameContainerBodyControls:IsVisible()")
        .unwrap());
    assert!(s
        .eval::<bool>("return OptionsFrameContainerDefaults:IsEnabled()")
        .unwrap());
    assert!(
        s.eval::<bool>("return OptionsFrameContainerBodyControlsRowStickyTargetCheck:GetChecked()")
            .unwrap(),
        "deselectOnClick '0' reads as Sticky Targeting CHECKED"
    );
    assert!(s
        .eval::<bool>("return OptionsFrameContainerBodyControlsRowAutoLootCheck:GetChecked()")
        .unwrap());
    assert!(!s
        .eval::<bool>("return OptionsFrameContainerBodyControlsRowInvertMouseCheck:GetChecked()")
        .unwrap());
    assert_eq!(
        s.eval::<String>("return OptionsFrameContainerBodyControlsRowStickyTargetLabel:GetText()")
            .unwrap(),
        "Sticky Targeting"
    );
    assert!(s.errors().is_empty(), "script errors: {:?}", s.errors());
}

/// The Controls checkboxes write their flags on the INTERFACE panel's kit mapping (checked →
/// CheckBoxOn — OptionsFrame.lua's PlayClickSound, NOT the Audio page's inverted quirk), and
/// Sticky Targeting writes the CVar inverted both ways.
#[test]
fn the_controls_checkboxes_write_flags_with_the_interface_panel_kit() {
    let mut s = harness_on(audio_harness());
    s.run("ShowUIPanel(OptionsFrame)").unwrap();
    assert!(
        s.take_cvar_changes().is_empty(),
        "reading the table on open must not write it back"
    );
    let _ = s.take_sounds();

    // Invert Mouse on: flag "1", and the just-CHECKED box plays CheckBoxOn (normal mapping).
    s.run("OptionsFrameContainerBodyControlsRowInvertMouseCheck:Click()")
        .unwrap();
    assert_eq!(
        s.take_cvar_changes(),
        vec![("mouseInvertPitch".to_string(), "1".to_string())]
    );
    assert!(s
        .take_sounds()
        .contains(&SoundRequest::KitName("igMainMenuOptionCheckBoxOn".into())));

    // Sticky Targeting on: the write INVERTS — checking it writes deselectOnClick "0".
    s.run("OptionsFrameContainerBodyControlsRowStickyTargetCheck:Click()")
        .unwrap();
    assert_eq!(
        s.take_cvar_changes(),
        vec![("deselectOnClick".to_string(), "0".to_string())]
    );

    // …and off again: back to "1", the just-UNchecked box on the CheckBoxOff kit.
    s.run("OptionsFrameContainerBodyControlsRowStickyTargetCheck:Click()")
        .unwrap();
    assert_eq!(
        s.take_cvar_changes(),
        vec![("deselectOnClick".to_string(), "1".to_string())]
    );
    assert!(s
        .take_sounds()
        .contains(&SoundRequest::KitName("igMainMenuOptionCheckBoxOff".into())));
    assert!(s.errors().is_empty(), "script errors: {:?}", s.errors());
}

/// Defaults on the Controls page: the moved flags come back (deselectOnClick "1",
/// autoLootDefault "0"), the rows follow, and only the moved values queue.
#[test]
fn defaults_resets_the_controls_page_to_registered_defaults() {
    let mut s = audio_harness();
    s.set_cvar_host("deselectOnClick", "0");
    s.set_cvar_host("autoLootDefault", "1");
    let mut s = harness_on(s);
    s.run("ShowUIPanel(OptionsFrame)").unwrap();
    let _ = s.take_cvar_changes();

    s.run("OptionsFrameContainerDefaults:Click()").unwrap();
    let changes = s.take_cvar_changes();
    assert!(
        changes.contains(&("deselectOnClick".to_string(), "1".to_string())),
        "{changes:?}"
    );
    assert!(
        changes.contains(&("autoLootDefault".to_string(), "0".to_string())),
        "{changes:?}"
    );
    assert_eq!(changes.len(), 2, "only the moved values queue: {changes:?}");
    assert!(
        !s.eval::<bool>(
            "return OptionsFrameContainerBodyControlsRowStickyTargetCheck:GetChecked()"
        )
        .unwrap(),
        "deselectOnClick back at '1' reads as Sticky Targeting unchecked"
    );
    assert!(!s
        .eval::<bool>("return OptionsFrameContainerBodyControlsRowAutoLootCheck:GetChecked()")
        .unwrap());
    assert!(s.errors().is_empty(), "script errors: {:?}", s.errors());
}

/// Drive the window a few frames so the frame-late fits (the scroll body, the tab widths)
/// converge: rects resolve after Lua runs, so OptionsScroll_Fit answers one frame behind.
fn settle(s: &mut UiScript) {
    for _ in 0..4 {
        s.resolve();
        s.tick(0.016);
    }
    s.resolve();
}

/// B217: a search that matches across categories chains five group heads and every matched row
/// into one column — ~150 units past the page area, which before the page scrolled drew straight
/// out through the dialog border onto the world. Now the body is the scroll child: it grows to the
/// content, the bar and its trough appear, and everything past the fold is CLIPPED to the page
/// rect until scrolled to.
#[test]
fn a_broad_search_scrolls_the_page_instead_of_overflowing_it() {
    let mut s = harness_on(audio_harness());
    s.run("ShowUIPanel(OptionsFrame)").unwrap();
    settle(&mut s);

    // Control first: a settled page fits, so there is no scroll and no bar at all — and the body
    // sits exactly on the page rect, the seat every page's XML anchors were authored against.
    assert_eq!(
        s.eval::<f32>("return OptionsFrameContainerScroll:GetVerticalScrollRange()")
            .unwrap(),
        0.0,
        "the Controls page fits its area"
    );
    for f in [
        "OptionsFrameContainerScrollBar",
        "OptionsFrameContainerScrollBarTrough",
    ] {
        assert!(
            !s.eval::<bool>(&format!("return {f}:IsVisible()")).unwrap(),
            "{f} stays away while the page fits"
        );
    }
    let page_h: f32 = s
        .eval("return OptionsFrameContainerScroll:GetHeight()")
        .unwrap();
    assert!(
        (s.eval::<f32>("return OptionsFrameContainerBody:GetHeight()")
            .unwrap()
            - page_h)
            .abs()
            < 0.5,
        "the body is the page rect when nothing overflows"
    );

    // Now the broad search: every category surfaces, and the column outruns the page.
    s.run("OptionsFrameSearchBox:SetText(\"e\")").unwrap();
    settle(&mut s);
    let range: f32 = s
        .eval("return OptionsFrameContainerScroll:GetVerticalScrollRange()")
        .unwrap();
    assert!(
        range > 100.0,
        "the results outrun the page, so there is something to scroll (range {range})"
    );
    for f in [
        "OptionsFrameContainerScrollBar",
        "OptionsFrameContainerScrollBarTrough",
    ] {
        assert!(
            s.eval::<bool>(&format!("return {f}:IsVisible()")).unwrap(),
            "{f} appears with the overflow"
        );
    }

    // THE SYMPTOM: nothing under the page draws past its bottom edge any more. Every quad the
    // page's own content emits carries the page rect as its clip (the engine's ScrollFrame
    // mechanism), so the deepest DRAWN pixel is the page's own bottom — while the content's own
    // rects still reach far below it, which is exactly the spill that used to be on screen.
    let quads = s.extract();
    let clip = quads
        .iter()
        .find_map(|q| q.clip)
        .expect("the page clips its content");
    assert!(
        quads.iter().all(|q| q.clip.is_none_or(|c| c == clip)),
        "one clip in play: the page area"
    );
    let deepest_rect = quads
        .iter()
        .filter(|q| q.clip.is_some())
        .filter_map(|q| q.rect)
        .map(|r| r.bottom)
        .fold(f32::INFINITY, f32::min);
    assert!(
        deepest_rect < clip.bottom - 100.0,
        "there is a real fold to make: the results reach {deepest_rect} against a page bottom of {}",
        clip.bottom
    );
    let deepest_drawn = quads
        .iter()
        .filter_map(|q| Some((q.rect?, q.clip?)))
        .map(|(r, c)| r.bottom.max(c.bottom))
        .fold(f32::INFINITY, f32::min);
    assert!(
        deepest_drawn >= clip.bottom - 0.01,
        "…and it is folded AT the page bottom, not spilling ({deepest_drawn} vs {})",
        clip.bottom
    );

    // The last result is reachable: scrolling to the end brings it inside the page rect. (Widget
    // coordinates here, not the extract's screen px — the window carries ERA_WINDOW_SCALE.)
    let sf_bottom: f32 = s
        .eval("return OptionsFrameContainerScroll:GetBottom()")
        .unwrap();
    let tail = |s: &UiScript| -> f32 { s.eval("return OptionsScroll_ContentBottom()").unwrap() };
    assert!(
        tail(&s) < sf_bottom,
        "the tail starts below the fold ({} vs {sf_bottom})",
        tail(&s)
    );
    s.run(&format!("OptionsFrameContainerScrollBar:SetValue({range})"))
        .unwrap();
    settle(&mut s);
    assert!(
        tail(&s) >= sf_bottom - 0.5,
        "scrolling to the end brings the tail into the page ({} vs {sf_bottom})",
        tail(&s)
    );

    // Clearing the search puts the page — and the bar with its trough — back.
    s.run("OptionsFrameSearchBox:SetText(\"\")").unwrap();
    settle(&mut s);
    assert_eq!(
        s.eval::<f32>("return OptionsFrameContainerScroll:GetVerticalScrollRange()")
            .unwrap(),
        0.0
    );
    for f in [
        "OptionsFrameContainerScrollBar",
        "OptionsFrameContainerScrollBarTrough",
    ] {
        assert!(
            !s.eval::<bool>(&format!("return {f}:IsVisible()")).unwrap(),
            "{f} goes away with the results"
        );
    }
    assert!(s.errors().is_empty(), "script errors: {:?}", s.errors());
}

/// The bar's TROUGH — the recessed channel it rides in, the "background and border" a bare
/// arrows-and-knob bar was missing. It is the shared kit's template on 1.12's own
/// UI-Character-ScrollBar channel art over the ref's black backing, and it seats ITSELF on its bar
/// at the ref's hang: 31 wide against the bar's 16, 8 units left, and — the part B224 caught —
/// overhanging the bar by 21 above and 20 below, which is what drops each arrow button into the
/// 16-tall SOCKET the art carries for it. (The Keybindings page's own bar wears the same one —
/// keybindings_tests, where the harness has a real binding registry to overflow the list with.)
#[test]
fn the_page_scroll_bar_wears_the_trough_with_its_arrows_in_the_sockets() {
    let mut s = harness_on(audio_harness());
    s.run("ShowUIPanel(OptionsFrame)").unwrap();
    s.run("OptionsFrameSearchBox:SetText(\"e\")").unwrap();
    settle(&mut s);

    let bar = "OptionsFrameContainerScrollBar";
    let trough = "OptionsFrameContainerScrollBarTrough";
    let g = |f: &str, m: &str| s.eval::<f32>(&format!("return {f}:{m}()")).unwrap();
    assert!(
        (g(trough, "GetWidth") - 31.0).abs() < 0.01,
        "the trough is the 31-wide channel"
    );
    assert!(
        (g(bar, "GetWidth") - 16.0).abs() < 0.01,
        "against a 16-wide bar"
    );
    assert!(
        (g(bar, "GetLeft") - g(trough, "GetLeft") - 8.0).abs() < 0.01,
        "the trough hangs the ref's 8 units left of the bar, so the bar rides it centred"
    );
    // THE SOCKET LAW (BenillaScrollTrough_Seat): the trough overhangs the bar by 21/20 — not the
    // arrow-to-arrow 16/16 that B224 reported, which sat both arrows 4 units OUT of their sockets,
    // riding the caps with bare socket showing beside them. Ref: ReputationFrame's trough at the
    // scroll frame's +5/-4 against a UIPanelScrollBarTemplate bar at -16/+16.
    assert!(
        (g(trough, "GetTop") - g(bar, "GetTop") - 21.0).abs() < 0.01,
        "trough top 21 above the bar"
    );
    assert!(
        (g(bar, "GetBottom") - g(trough, "GetBottom") - 20.0).abs() < 0.01,
        "trough bottom 20 below the bar"
    );
    // Read the same law off the ARROWS, which is what the eye actually judges: 5 units of top cap
    // above the up arrow, 4 of bottom cap below the down arrow, and the 16-tall sockets between.
    let up = format!("{bar}ScrollUpButton");
    let down = format!("{bar}ScrollDownButton");
    assert!((g(&up, "GetHeight") - 16.0).abs() < 0.01, "16-tall arrows");
    assert!((g(&down, "GetHeight") - 16.0).abs() < 0.01);
    assert!(
        (g(trough, "GetTop") - g(&up, "GetTop") - 5.0).abs() < 0.01,
        "the cap shows 5 above the up arrow"
    );
    assert!(
        (g(&down, "GetBottom") - g(trough, "GetBottom") - 4.0).abs() < 0.01,
        "and 4 below the down arrow"
    );
    // …and on THIS page the whole channel lands on the page rect: the scroll frame is the page
    // area, so the bar takes the 21/20 inset rather than the trough poking out through the header
    // divider above and the container's bottom below.
    let sf = "OptionsFrameContainerScroll";
    assert!((g(trough, "GetTop") - g(sf, "GetTop")).abs() < 0.01);
    assert!((g(trough, "GetBottom") - g(sf, "GetBottom")).abs() < 0.01);

    // The art: three channel slices from the one 1.12 file — top cap, stretched run, bottom cap —
    // each spanning the channel's full width, stacked with no gap and no overlap.
    let mut slices: Vec<_> = s
        .extract()
        .into_iter()
        .filter_map(|q| match &q.content {
            QuadContent::Texture { path: Some(p), .. } if p.contains("UI-Character-ScrollBar") => {
                q.rect
            }
            _ => None,
        })
        .collect();
    assert_eq!(slices.len(), 3, "top cap, stretched run, bottom cap");
    slices.sort_by(|a, b| b.top.total_cmp(&a.top));
    assert!(
        slices
            .windows(2)
            .all(|w| (w[0].bottom - w[1].top).abs() < 0.01),
        "the three stack flush into one channel: {slices:?}"
    );
    let width = slices[0].right - slices[0].left;
    assert!(
        slices
            .iter()
            .all(|r| (r.right - r.left - width).abs() < 0.01),
        "…all at the channel's own width: {slices:?}"
    );
    assert!(s.errors().is_empty(), "script errors: {:?}", s.errors());
}

// ── B223 · the row tooltips (decision 1054) ─────────────────────────────────────────────────────

/// Hover the middle of a named row's LABEL half (left of the control column) — the surface the
/// reporter's cursor was on when the row lit and said nothing. Callers pin `ERA_WINDOW_SCALE = 1`
/// first (the wash test's own idiom): frame rects are in the frame's scale space, the pointer is
/// in the screen's, and at scale 1 the two are the same numbers.
fn hover_label(s: &mut UiScript, frame: &str) {
    s.resolve();
    let g = |s: &mut UiScript, verb: &str| -> f32 {
        s.eval(&format!("return {frame}:{verb}()")).unwrap()
    };
    let (l, t, b) = (g(s, "GetLeft"), g(s, "GetTop"), g(s, "GetBottom"));
    s.mouse_move(l + 60.0, (t + b) * 0.5);
}

/// A hovered row raises its 1.12 description, on the era's seat, and drops it on leave — the row
/// itself, its checkbox, and (B223's report) the label the cursor actually crosses. The string
/// resolves by KEY at hover, so seeding it AFTER the window loaded still paints: that is the
/// property the 1.12 panel's own `getglobal("OPTION_TOOLTIP_"..key)` lookup buys.
#[test]
fn a_hovered_row_raises_its_1_12_description_on_the_era_seat() {
    let mut s = harness_on(audio_harness());
    s.run("OPTION_TOOLTIP_GAMEFIELD_DESELECT = \"Checking this will prevent the deselection.\"")
        .unwrap();
    s.run("ERA_WINDOW_SCALE = 1").unwrap();
    s.run("ShowUIPanel(OptionsFrame)").unwrap();

    let row = "OptionsFrameContainerBodyControlsRowStickyTarget";
    hover_label(&mut s, row);
    s.resolve();
    assert!(
        s.eval::<bool>("return GameTooltip:IsVisible()").unwrap(),
        "the label half raises the plate — the reported gap"
    );
    assert_eq!(
        s.eval::<String>("return GameTooltipTextLeft1:GetText()")
            .unwrap(),
        "Checking this will prevent the deselection."
    );
    assert_eq!(
        s.eval::<i64>("return GameTooltip:NumLines()").unwrap(),
        1,
        "the description ALONE — the era's white name line is cut (1054)"
    );
    // The era seat: BOTTOMLEFT on the label region's TOPRIGHT, hung 10 back over the control
    // column (DefaultTooltipMixin's ANCHOR_RIGHT / x -10).
    let owned: bool = s
        .eval(&format!("return GameTooltip:IsOwned({row}Tip)"))
        .unwrap();
    assert!(owned, "owned by the row's $parentTip region");
    let (tip_right, tip_top): (f32, f32) = (
        s.eval(&format!("return {row}Tip:GetRight()")).unwrap(),
        s.eval(&format!("return {row}Tip:GetTop()")).unwrap(),
    );
    let (left, bottom): (f32, f32) = (
        s.eval("return GameTooltip:GetLeft()").unwrap(),
        s.eval("return GameTooltip:GetBottom()").unwrap(),
    );
    assert!(
        (left - (tip_right - 10.0)).abs() < 0.01 && (bottom - tip_top).abs() < 0.01,
        "plate at ({left}, {bottom}); the era seat is ({}, {tip_top})",
        tip_right - 10.0
    );

    // Crossing onto the checkbox keeps it up (one seam lights the wash and raises the plate, so
    // the row's OnLeave and the box's OnEnter cancel out inside the one move).
    let (bl, br, bt, bb): (f32, f32, f32, f32) = (
        s.eval(&format!("return {row}Check:GetLeft()")).unwrap(),
        s.eval(&format!("return {row}Check:GetRight()")).unwrap(),
        s.eval(&format!("return {row}Check:GetTop()")).unwrap(),
        s.eval(&format!("return {row}Check:GetBottom()")).unwrap(),
    );
    s.mouse_move((bl + br) * 0.5, (bt + bb) * 0.5);
    assert!(
        s.eval::<bool>("return GameTooltip:IsVisible()").unwrap(),
        "the plate survives the crossing onto the control"
    );

    // Leaving the row puts it away.
    s.mouse_move(5.0, 5.0);
    assert!(
        !s.eval::<bool>("return GameTooltip:IsVisible()").unwrap(),
        "OnLeave drops the plate"
    );
    assert!(s.errors().is_empty(), "script errors: {:?}", s.errors());
}

/// The row with no 1.12 string raises NOTHING — not a plate echoing the label under the cursor,
/// and not the LAST row's description left standing over it. Auto Loot is that row: 1.12 has no
/// Auto Loot setting, so no `OPTION_TOOLTIP_*` for it. The second leg is the live probe's find: a
/// hover driven without the outgoing row's OnLeave (1054) must still put the neighbour away.
#[test]
fn a_row_with_no_1_12_string_raises_no_plate() {
    let mut s = harness_on(audio_harness());
    s.run("OPTION_TOOLTIP_GAMEFIELD_DESELECT = \"Sticky's own description.\"")
        .unwrap();
    s.run("ERA_WINDOW_SCALE = 1").unwrap();
    s.run("ShowUIPanel(OptionsFrame)").unwrap();
    hover_label(&mut s, "OptionsFrameContainerBodyControlsRowAutoLoot");
    s.resolve();
    assert!(
        !s.eval::<bool>("return GameTooltip:IsVisible()").unwrap(),
        "no 1.12 description, no plate"
    );
    assert!(
        s.eval::<bool>("return OptionsFrameContainerBodyControlsRowAutoLootHover:IsVisible()")
            .unwrap(),
        "…but the row still lights: the wash is not gated on the string"
    );

    // Sticky's plate up, then straight into the mute row with no OnLeave in between.
    s.run("OptionsRow_Hover(OptionsFrameContainerBodyControlsRowStickyTarget, 1)")
        .unwrap();
    assert!(s.eval::<bool>("return GameTooltip:IsVisible()").unwrap());
    s.run("OptionsRow_Hover(OptionsFrameContainerBodyControlsRowAutoLoot, 1)")
        .unwrap();
    assert!(
        !s.eval::<bool>("return GameTooltip:IsVisible()").unwrap(),
        "the mute row puts the neighbour's description away — it never describes THIS row"
    );
    assert!(s.errors().is_empty(), "script errors: {:?}", s.errors());
}

/// The RUNTIME leg on the real client data (`ui_quest`'s pattern): every key the rows carry
/// resolves to a non-empty string in the shipped 1.12 `GlobalStrings.lua` — the guard against a
/// typo'd key degrading a description to silence — and the ONE row without a key is Auto Loot.
/// Pins the reporter's own row end to end (B223's screenshot text). Skips without client data.
#[test]
fn every_row_tooltip_key_resolves_in_the_real_global_strings() {
    let data = benilla_formats::wow_data_or_skip!();
    let mut chain = benilla_formats::open_chain(&data).expect("open chain");
    let src = chain
        .read_file("Interface\\FrameXML\\GlobalStrings.lua")
        .expect("GlobalStrings.lua in the chain");
    let strings = UiScript::new().expect("VM");
    strings
        .run(&String::from_utf8_lossy(&src))
        .expect("GlobalStrings runs clean");

    // The mapping, read off the LIVE rows so a page added later can't slip the check.
    let s = harness();
    let listing: String = s
        .eval(
            "local out = {} \
             for page, rows in pairs(OPTIONS_PAGE_ROWS) do \
               for _, rkey in ipairs(rows) do \
                 local row = getglobal(\"OptionsFrameContainerBody\" .. page .. rkey) \
                 table.insert(out, page .. rkey .. \"=\" .. (row.tip or \"\")) \
               end \
             end \
             return table.concat(out, \",\")",
        )
        .unwrap();

    let mut untipped = vec![];
    let mut checked = 0;
    for entry in listing.split(',') {
        let (row, key) = entry.split_once('=').expect("row=key");
        if key.is_empty() {
            untipped.push(row.to_string());
            continue;
        }
        assert!(
            key.starts_with("OPTION_TOOLTIP_"),
            "{row}: {key} is not a 1.12 option-tooltip key"
        );
        let text: String = strings
            .lua()
            .globals()
            .get::<String>(key)
            .unwrap_or_default();
        assert!(
            !text.is_empty() && text != "PLACE_HOLDER",
            "{row}: {key} resolves to nothing in the real GlobalStrings"
        );
        checked += 1;
    }
    // 27 CVar rows (the Chat page's two bubble switches are 1139's and its Detailed Loot
    // Information + Guild Member Alert are 1589's; Status Bar Text, Mouse Sensitivity
    // and Max Camera Distance 1140's; Graphics' Vertical Sync is 1394's, its Windowed Mode
    // 1627's and its Multisampling 1632's; Camera Following Style
    // 1493's; Terrain Distance 1513's) + the Combat page's 14 saved-variable rows (1134) + the Interface page's 6 (3 from
    // 1136, Buff Durations 1139, the target-of-target pair 1576), the Action Bars page's 2 (the
    // lock 1136, Always Show
    // ActionBars 1500) and the Chat page's 1 (Remove Chat Hover Delay, 1589) + 6 API rows (the Interface page's Show Cloak / Show Helm, 1472; the Action
    // Bars page's four multibar switches, 1500) — which is the point of counting here rather than
    // per page: the third store's rows are held to the same "the key is 1.12's own and it resolves"
    // bar as the other two. Camera Following Style is counted on the key it wears at rest (Smart's
    // OPTION_TOOLTIP_CAMERA1) and Show When on its own (Always's OPTION_TOOLTIP_TARGETOFTARGET5);
    // their other entries ride the same census as the selection moves.
    assert_eq!(checked, 55, "every tipped row carries a live 1.12 key");
    assert_eq!(
        untipped,
        vec![
            "ControlsRowAutoLoot".to_string(),
            "NameplatesRowEnemyPlates".to_string(),
            "NameplatesRowFriendlyPlates".to_string(),
        ],
        "the rows with no 1.12 option-tooltip string: Auto Loot (no 1.12 setting at all) and \
         the two V-plate toggles (1.12 HAS the setting, as the V/Shift-V keybinding over a \
         RegisterForSave'd global, but its options UI never carried a row for it — its own \
         UIOptionsFrame comment says so — so there is no OPTION_TOOLTIP_ key to resolve)"
    );

    // The reporter's row, byte for byte off the MPQ chain.
    assert_eq!(
        strings
            .lua()
            .globals()
            .get::<String>("OPTION_TOOLTIP_GAMEFIELD_DESELECT")
            .unwrap(),
        "Checking this will prevent the deselection of targets by clicking on the gamefield.  \
         Targets can only be cleared by pressing escape or clicking another target."
    );
}

/// EVERY row on every page, all three control flavors: hovering it raises a plate exactly when
/// the row carries a 1.12 key, and no row's hover errors. The teeth are the per-template
/// `$parentTip` seat — a flavor missing that region would take `SetOwner(nil, …)` and print a red
/// line instead of a plate, which no key-mapping check would ever see.
#[test]
fn every_flavor_of_row_raises_its_plate_from_the_page_it_lives_on() {
    let mut s = harness_on(audio_harness());
    // Stand-in strings for every key the rows name (the real texts are the data test's job).
    s.run(
        "for page, rows in pairs(OPTIONS_PAGE_ROWS) do \
           for _, rkey in ipairs(rows) do \
             local row = getglobal(\"OptionsFrameContainerBody\" .. page .. rkey) \
             if row.tip then setglobal(row.tip, \"described: \" .. rkey) end \
           end \
         end",
    )
    .unwrap();
    s.run("ERA_WINDOW_SCALE = 1").unwrap();
    s.run("ShowUIPanel(OptionsFrame)").unwrap();

    let mut raised = 0;
    for page in [
        "Controls",
        "Audio",
        "Graphics",
        "Nameplates",
        "Combat",
        "Interface",
        "ActionBars",
        "Chat",
    ] {
        s.run(&format!("OptionsFrameCategoryListRow{page}:Click()"))
            .unwrap();
        let rows: String = s
            .eval(&format!(
                "return table.concat(OPTIONS_PAGE_ROWS.{page}, \",\")"
            ))
            .unwrap();
        for rkey in rows.split(',') {
            let row = format!("OptionsFrameContainerBody{page}{rkey}");
            hover_label(&mut s, &row);
            s.resolve();
            let tipped: bool = s.eval(&format!("return {row}.tip ~= nil")).unwrap();
            let shown: bool = s.eval("return GameTooltip:IsVisible()").unwrap();
            assert_eq!(
                shown, tipped,
                "{row}: plate shown {shown}, has key {tipped}"
            );
            if tipped {
                assert_eq!(
                    s.eval::<String>("return GameTooltipTextLeft1:GetText()")
                        .unwrap(),
                    format!("described: {rkey}"),
                    "{row}: the plate reads ITS OWN row's description"
                );
                assert!(
                    s.eval::<bool>(&format!("return GameTooltip:IsOwned({row}Tip)"))
                        .unwrap(),
                    "{row}: seated on its own $parentTip region"
                );
                raised += 1;
            }
            s.mouse_move(5.0, 5.0);
        }
        assert!(
            s.errors().is_empty(),
            "{page}: script errors: {:?}",
            s.errors()
        );
    }
    // 27 of the 28 CVar rows (the Chat page's two bubble switches are 1139's and its Detailed
    // Loot Information + Guild Member Alert 1589's; Status Bar Text, Mouse Sensitivity and
    // Max Camera Distance 1140's; Vertical Sync 1394's, Windowed Mode 1627's and Multisampling
    // 1632's; Camera Following
    // Style 1493's; Terrain Distance 1513's), plus the Combat page's 14 saved-variable rows (1134), the Interface
    // page's 6 (1136, + Buff Durations 1139, + the target-of-target pair 1576), Action Bars' 2
    // (the lock 1136, Always Show
    // ActionBars 1500), the Chat page's 1 (Remove Chat Hover Delay, 1589) and 6 API rows (Show
    // Cloak / Show Helm, 1472; the four multibar switches, 1500).
    assert_eq!(raised, 55, "every row but Auto Loot has a 1.12 description");
}

/// The **Combat page** (decision 1134) — the first rows in this window whose store is a
/// saved-variable GLOBAL rather than a CVar, and so the first thing that can change any of the
/// stock globals 1128 ported. The page is 1.12's AdvancedOptionsCombatText box: it reads the
/// globals on select, a click writes the global (and *nothing* reaches the CVar table), and each
/// write runs the family's `applyFunc` — `CombatText_UpdateDisplayedMessages`, whose visible
/// effect is the per-type `show` flag and the scroll function.
#[test]
fn the_combat_page_writes_saved_variable_globals_and_applies_them() {
    let mut s = combat_harness();
    s.run("ShowUIPanel(OptionsFrame)").unwrap();
    s.run("OptionsFrameCategoryListRowCombat:Click()").unwrap();
    assert!(s
        .eval::<bool>("return OptionsFrameContainerBodyCombat:IsVisible()")
        .unwrap());
    assert!(s
        .eval::<bool>("return OptionsFrameContainerDefaults:IsEnabled()")
        .unwrap());

    // Read: each box shows its global, at CombatText.xml's own file-scope value.
    for (row, checked) in [
        ("RowCombatText", true),
        ("RowAuras", true),
        ("RowAuraFade", false),
        ("RowDodgeParryMiss", false),
    ] {
        assert_eq!(
            s.eval::<bool>(&format!(
                "return OptionsFrameContainerBodyCombat{row}Check:GetChecked() and true or false"
            ))
            .unwrap(),
            checked,
            "{row} reads its global"
        );
    }
    // The dropdown capsule reads COMBAT_TEXT_FLOAT_MODE = "1" as its named stop.
    assert_eq!(
        s.eval::<String>(
            "return OptionsFrameContainerBodyCombatRowFloatModeDropdownText:GetText()"
        )
        .unwrap(),
        "Scroll Up"
    );

    // Write: the global moves, the CVar table is untouched, and the applyFunc lands.
    let _ = s.take_cvar_changes();
    s.run("OptionsFrameContainerBodyCombatRowDodgeParryMissCheck:Click()")
        .unwrap();
    assert_eq!(
        s.eval::<String>("return COMBAT_TEXT_SHOW_DODGE_PARRY_MISS")
            .unwrap(),
        "1"
    );
    assert!(
        s.take_cvar_changes().is_empty(),
        "a uvar row must not touch the CVar table"
    );
    assert_eq!(
        s.eval::<i64>("return COMBAT_TEXT_TYPE_INFO[\"MISS\"].show or 0")
            .unwrap(),
        1,
        "applyFunc ran: the message type is live now"
    );

    // The dropdown writes its global and applies too (the scroll function follows the mode).
    s.run(
        "OptionsFrameContainerBodyCombatRowFloatModeDropdownButton:Click() \
         DropDownList1Button2:Click()",
    )
    .unwrap();
    assert_eq!(
        s.eval::<String>("return COMBAT_TEXT_FLOAT_MODE").unwrap(),
        "2"
    );
    assert!(
        s.eval::<bool>("return COMBAT_TEXT_SCROLL_FUNCTION == CombatText_StandardScroll")
            .unwrap(),
        "mode 2 keeps the standard scroll with a downward step (CombatText.xml's own arm)"
    );
    assert!(s.errors().is_empty(), "script errors: {:?}", s.errors());
}

/// The master's dependency rule, 1.12's verbatim: `SHOW_COMBAT_TEXT` off greys **every** other
/// row on the page including the dropdown, and back on wakes them — except Combo Points, which
/// carries the reference's second gate and stays greyed for anyone who is not a rogue or druid.
#[test]
fn the_combat_master_greys_the_family_and_combo_points_is_class_gated() {
    let mut s = combat_harness();
    s.run("ShowUIPanel(OptionsFrame)").unwrap();
    s.run("OptionsFrameCategoryListRowCombat:Click()").unwrap();

    let enabled = |s: &mut UiScript, row: &str, control: &str| -> bool {
        s.eval::<bool>(&format!(
            "return OptionsFrameContainerBodyCombat{row}{control}:IsEnabled() and true or false"
        ))
        .unwrap()
    };
    // No player class in this VM, so Combo Points is greyed from the start while its siblings
    // are live — the two gates are independent.
    assert!(enabled(&mut s, "RowAuras", "Check"));
    assert!(!enabled(&mut s, "RowComboPoints", "Check"));
    assert!(enabled(&mut s, "RowFloatMode", "DropdownButton"));

    s.run("OptionsFrameContainerBodyCombatRowCombatTextCheck:Click()")
        .unwrap();
    assert_eq!(s.eval::<String>("return SHOW_COMBAT_TEXT").unwrap(), "0");
    assert!(
        !enabled(&mut s, "RowAuras", "Check"),
        "the master off greys every sub-toggle"
    );
    assert!(
        !enabled(&mut s, "RowFloatMode", "DropdownButton"),
        "…and the scroll dropdown, so its list cannot even open"
    );
    assert!(
        enabled(&mut s, "RowCombatText", "Check"),
        "the master itself stays live — it is the way back"
    );

    s.run("OptionsFrameContainerBodyCombatRowCombatTextCheck:Click()")
        .unwrap();
    assert!(enabled(&mut s, "RowAuras", "Check"));
    assert!(enabled(&mut s, "RowFloatMode", "DropdownButton"));
    assert!(
        !enabled(&mut s, "RowComboPoints", "Check"),
        "the class gate outlives the master's return"
    );
    assert!(s.errors().is_empty(), "script errors: {:?}", s.errors());
}

/// Defaults on a saved-variable page restores each global to **the value its own XML assigned at
/// file scope** — captured at the row's OnLoad, which the load order guarantees runs before the
/// saved chunk (1128). The panel restates no defaults of its own, so it cannot drift from
/// CombatText.xml the way the reference's hand-copied `default` field can.
#[test]
fn defaults_resets_the_combat_page_to_the_shipped_assignments() {
    let s = combat_harness();
    s.run("ShowUIPanel(OptionsFrame)").unwrap();
    s.run("OptionsFrameCategoryListRowCombat:Click()").unwrap();
    // Move three of them off their shipped values, in both directions and both flavors.
    s.run(
        "OptionsFrameContainerBodyCombatRowAurasCheck:Click() \
         OptionsFrameContainerBodyCombatRowReputationCheck:Click() \
         OptionsFrameContainerBodyCombatRowFloatModeDropdownButton:Click() \
         DropDownList1Button3:Click()",
    )
    .unwrap();
    assert_eq!(
        s.eval::<String>("return COMBAT_TEXT_SHOW_AURAS").unwrap(),
        "0"
    );
    assert_eq!(
        s.eval::<String>("return COMBAT_TEXT_SHOW_REPUTATION")
            .unwrap(),
        "1"
    );
    assert_eq!(
        s.eval::<String>("return COMBAT_TEXT_FLOAT_MODE").unwrap(),
        "3"
    );

    s.run("OptionsFrameContainerDefaults:Click()").unwrap();
    assert_eq!(
        s.eval::<String>("return COMBAT_TEXT_SHOW_AURAS").unwrap(),
        "1"
    );
    assert_eq!(
        s.eval::<String>("return COMBAT_TEXT_SHOW_REPUTATION")
            .unwrap(),
        "0"
    );
    assert_eq!(
        s.eval::<String>("return COMBAT_TEXT_FLOAT_MODE").unwrap(),
        "1"
    );
    assert_eq!(
        s.eval::<String>(
            "return OptionsFrameContainerBodyCombatRowFloatModeDropdownText:GetText()"
        )
        .unwrap(),
        "Scroll Up",
        "the capsule follows the reset"
    );
    assert!(s.errors().is_empty(), "script errors: {:?}", s.errors());
}

/// The point of the whole page: what it writes is **remembered**. A toggle lands in the
/// saved-variables text (1128's serializer) under its own name, and a fresh VM that executes that
/// text comes up with the player's choice rather than CombatText.xml's shipped default.
#[test]
fn what_the_combat_page_writes_survives_a_restart() {
    let s = combat_harness();
    s.run("ShowUIPanel(OptionsFrame)").unwrap();
    s.run("OptionsFrameCategoryListRowCombat:Click()").unwrap();
    s.run("OptionsFrameContainerBodyCombatRowHonorGainedCheck:Click()")
        .unwrap();

    let saved = s.saved_variables_text();
    assert!(
        saved.contains("COMBAT_TEXT_SHOW_HONOR_GAINED = \"0\""),
        "the toggle is in the saved text:\n{saved}"
    );

    // The restart: a fresh tree at its shipped defaults, then the saved chunk over the top.
    let fresh = combat_harness();
    assert_eq!(
        fresh
            .eval::<String>("return COMBAT_TEXT_SHOW_HONOR_GAINED")
            .unwrap(),
        "1"
    );
    fresh.run(&saved).unwrap();
    assert_eq!(
        fresh
            .eval::<String>("return COMBAT_TEXT_SHOW_HONOR_GAINED")
            .unwrap(),
        "0",
        "the saved value wins over the file-scope default"
    );
    // And the page paints the restored value the next time it is opened.
    fresh.run("ShowUIPanel(OptionsFrame)").unwrap();
    fresh
        .run("OptionsFrameCategoryListRowCombat:Click()")
        .unwrap();
    assert!(!fresh
        .eval::<bool>(
            "return OptionsFrameContainerBodyCombatRowHonorGainedCheck:GetChecked() and true or false"
        )
        .unwrap());
    assert!(
        fresh.errors().is_empty(),
        "script errors: {:?}",
        fresh.errors()
    );
}

/// The **Action Bars page**'s lock row (decision 1136) — the one global on that group whose store
/// is a uvar. It is also the page whose setting had to be BUILT first: 1134 §3 listed
/// `LOCK_ACTIONBAR` as "not defined, and no guard exists". The five switches above it are 1500's
/// and have their own test below.
///
/// The end-to-end teeth are the last block: the row's write reaches the shipped bar's own drag
/// guard in the same VM. `action_bar_tests`/`pet_bar_tests` own the guard's full behaviour
/// (including the shift-click that deliberately still works); this owns the wire between them.
#[test]
fn the_action_bars_page_locks_the_real_bar() {
    let mut s = actionbars_harness();
    s.run("ShowUIPanel(OptionsFrame)").unwrap();
    s.run("OptionsFrameCategoryListRowActionBars:Click()")
        .unwrap();
    assert!(s
        .eval::<bool>("return OptionsFrameContainerBodyActionBars:IsVisible()")
        .unwrap());
    assert!(
        !s.eval::<bool>(
            "return OptionsFrameContainerBodyActionBarsRowLockActionBarCheck:GetChecked() \
             and true or false"
        )
        .unwrap(),
        "unchecked: ActionBar.xml ships the bar unlocked"
    );

    let _ = s.take_cvar_changes();
    s.run("OptionsFrameContainerBodyActionBarsRowLockActionBarCheck:Click()")
        .unwrap();
    assert_eq!(s.eval::<String>("return LOCK_ACTIONBAR").unwrap(), "1");
    assert!(
        s.take_cvar_changes().is_empty(),
        "a uvar row must not touch the CVar table"
    );

    // The real bar, in this same VM, now refuses the drag — the row and the guard are wired.
    s.set_action(
        1,
        Some(benilla_ui::script::ActionSlot {
            texture: Some("Interface\\Icons\\Spell_A".into()),
            kind: 0x00,
            action: 111,
            count: 0,
            consumable: false,
        }),
    );
    s.fire_event("PLAYER_ENTERING_WORLD", vec![]);
    s.resolve();
    s.run("BenillaActionButton_OnDragStart(ActionButton1)")
        .unwrap();
    assert!(
        s.cursor_payload().is_none(),
        "the page's write reached the bar's guard"
    );

    // Defaults walks it back to ActionBar.xml's own assignment, and the bar drags again.
    s.run("OptionsFrameContainerDefaults:Click()").unwrap();
    assert_eq!(s.eval::<String>("return LOCK_ACTIONBAR").unwrap(), "0");
    s.run("BenillaActionButton_OnDragStart(ActionButton1)")
        .unwrap();
    assert!(s.cursor_payload().is_some(), "unlocked again");
    assert!(s.errors().is_empty(), "script errors: {:?}", s.errors());
}

/// The **Interface page** (decision 1136) — the second store's second page, and the three globals
/// 1134 §3 named as ready: already defined, already consumed, needing only a row. Each box reads
/// its definer's own file-scope assignment, and a click writes the global and touches nothing else.
///
/// None of the three carries an `applyFunc`, and that is the property being asserted at the end:
/// the consumer reads the global as it acts, so the write alone changes behaviour — here, the
/// questgiver's instant-text arm, live on the very next show.
#[test]
fn the_interface_page_writes_the_three_stock_globals() {
    let mut s = interface_harness();
    s.run("ShowUIPanel(OptionsFrame)").unwrap();
    s.run("OptionsFrameCategoryListRowInterface:Click()")
        .unwrap();
    assert!(s
        .eval::<bool>("return OptionsFrameContainerBodyInterface:IsVisible()")
        .unwrap());
    assert!(s
        .eval::<bool>("return OptionsFrameContainerDefaults:IsEnabled()")
        .unwrap());

    // Read: all three ship on — QuestFrame.xml's "1" (the director's pin), QuestLogFrame.xml's "1"
    // (the reference's advertised default, as a STRING — see that file on 1.12's own number/string
    // break), GameTooltip.xml's "1".
    for row in ["RowInstantQuestText", "RowAutoQuestWatch", "RowNewbieTips"] {
        assert!(
            s.eval::<bool>(&format!(
                "return OptionsFrameContainerBodyInterface{row}Check:GetChecked() and true or false"
            ))
            .unwrap(),
            "{row} reads its global"
        );
    }

    // Write: the global moves, and the CVar table is never reached.
    let _ = s.take_cvar_changes();
    s.run("OptionsFrameContainerBodyInterfaceRowNewbieTipsCheck:Click()")
        .unwrap();
    assert_eq!(s.eval::<String>("return SHOW_NEWBIE_TIPS").unwrap(), "0");
    s.run("OptionsFrameContainerBodyInterfaceRowAutoQuestWatchCheck:Click()")
        .unwrap();
    assert_eq!(s.eval::<String>("return AUTO_QUEST_WATCH").unwrap(), "0");
    assert!(
        s.take_cvar_changes().is_empty(),
        "a uvar row must not touch the CVar table"
    );

    // No applyFunc, because the write IS the apply: the questgiver's fade arm reads the global as
    // the panel shows, so turning instant text OFF makes the very next show write on.
    s.run("OptionsFrameContainerBodyInterfaceRowInstantQuestTextCheck:Click()")
        .unwrap();
    assert_eq!(
        s.eval::<String>("return QUEST_FADING_DISABLE").unwrap(),
        "0"
    );
    assert!(
        s.eval::<bool>(
            "return OptionsFrameContainerBodyInterfaceRowInstantQuestText.applyFunc == nil"
        )
        .unwrap(),
        "these three need no apply hook"
    );
    assert!(s.errors().is_empty(), "script errors: {:?}", s.errors());
}

/// The **target-of-target pair** (decision 1576) — the Interface page's first dependent rows and
/// the window's first `uvar` DROPDOWN. Three things here belong to no other row:
///
/// * the picker is dead while the switch is off, which is 1.12's own rule for exactly this pair
///   (`OptionsFrame_DisableDropDown`, UIOptionsFrame.lua l.694-700);
/// * both rows carry the same `applyFunc`, and unlike the three stock globals above they NEED one
///   — the frame's visibility is decided once and kept, and the saved chunk lands after the file
///   that decided it, so without the re-run a saved "1" would leave the frame hidden;
/// * the picker's five values are the reference's own strings, in its own order.
#[test]
fn the_target_of_target_rows_gate_each_other_and_write_their_globals() {
    let mut s = interface_harness();
    s.run("ShowUIPanel(OptionsFrame)").unwrap();
    s.run("OptionsFrameCategoryListRowInterface:Click()")
        .unwrap();

    // Ships off, at "always" — 1.12's own two defaults, read off UnitFrames.xml's file scope.
    assert!(
        !s.eval::<bool>(
            "return OptionsFrameContainerBodyInterfaceRowTargetOfTargetCheck:GetChecked() \
             and true or false"
        )
        .unwrap(),
        "the switch ships off"
    );
    assert_eq!(
        s.eval::<String>(
            "return OptionsFrameContainerBodyInterfaceRowTargetOfTargetModeDropdownText:GetText()"
        )
        .unwrap(),
        "Always"
    );
    assert!(
        !s.eval::<bool>(
            "return OptionsFrameContainerBodyInterfaceRowTargetOfTargetModeDropdownButton \
             :IsEnabled() and true or false"
        )
        .unwrap(),
        "the picker is dead while the switch is off"
    );

    // The switch: the global moves, the CVar table is never reached, and the picker wakes.
    let _ = s.take_cvar_changes();
    s.run("OptionsFrameContainerBodyInterfaceRowTargetOfTargetCheck:Click()")
        .unwrap();
    assert_eq!(
        s.eval::<String>("return SHOW_TARGET_OF_TARGET").unwrap(),
        "1"
    );
    assert!(
        s.take_cvar_changes().is_empty(),
        "a uvar row must not touch the CVar table"
    );
    assert!(
        s.eval::<bool>(
            "return OptionsFrameContainerBodyInterfaceRowTargetOfTargetModeDropdownButton \
             :IsEnabled() and true or false"
        )
        .unwrap(),
        "and the picker wakes with it"
    );
    assert!(
        s.eval::<bool>(
            "return OptionsFrameContainerBodyInterfaceRowTargetOfTarget.applyFunc \
                 == TargetofTarget_Update \
             and OptionsFrameContainerBodyInterfaceRowTargetOfTargetMode.applyFunc \
                 == TargetofTarget_Update"
        )
        .unwrap(),
        "both rows re-decide the frame when they are written"
    );

    // The picker: five entries in the reference's order, the stored value checked, and a pick
    // writes the reference's own value string.
    s.run("OptionsFrameContainerBodyInterfaceRowTargetOfTargetModeDropdownButton:Click()")
        .unwrap();
    assert_eq!(
        s.eval::<f64>("return DropDownList1.numButtons").unwrap(),
        5.0
    );
    assert!(
        s.eval::<bool>("return DropDownList1Button5Check:IsVisible()")
            .unwrap(),
        "Always is the one checked"
    );
    s.run("DropDownList1Button3:Click()").unwrap();
    assert_eq!(
        s.eval::<String>("return SHOW_TARGET_OF_TARGET_STATE")
            .unwrap(),
        "3",
        "Solo is the reference's third value"
    );
    assert_eq!(
        s.eval::<String>(
            "return OptionsFrameContainerBodyInterfaceRowTargetOfTargetModeDropdownText:GetText()"
        )
        .unwrap(),
        "Solo"
    );
    assert!(
        s.take_cvar_changes().is_empty(),
        "still nothing in the CVar table"
    );
    assert!(s.errors().is_empty(), "script errors: {:?}", s.errors());
}

/// The **equipment-display rows** — Show Cloak and Show Helm (decision 1472, B123). They are the
/// window's third kind of row and the only one with no store at all: the preference is a bit of the
/// character's own server-side `PLAYER_FLAGS`, so the row reads an engine getter and writes an
/// engine setter, 1.12's own `func`/`setFunc` pair for exactly these two entries.
///
/// Three things are asserted that no other row shape can be: the read comes from the API rather
/// than a saved value (a page revisit re-asks), the write leaves both the CVar table and the global
/// namespace untouched and produces a **wire** intent instead, and the getter follows the click
/// immediately — before the server's descriptor answers — because the wire verb is a blind flip and
/// a second click inside that round trip would otherwise compute the wrong direction.
#[test]
fn the_equipment_display_rows_read_and_write_through_the_api_not_a_store() {
    let mut s = interface_harness();
    s.run("ShowUIPanel(OptionsFrame)").unwrap();
    s.run("OptionsFrameCategoryListRowInterface:Click()")
        .unwrap();

    // Both ship shown — the model's own default, and the reference's hand-written one.
    for row in ["RowShowHelm", "RowShowCloak"] {
        assert!(
            s.eval::<bool>(&format!(
                "return OptionsFrameContainerBodyInterface{row}Check:GetChecked() and true or false"
            ))
            .unwrap(),
            "{row} reads the API"
        );
    }

    let _ = s.take_cvar_changes();
    let _ = s.take_worn_display_toggles();
    s.run("OptionsFrameContainerBodyInterfaceRowShowHelmCheck:Click()")
        .unwrap();
    assert_eq!(
        s.take_worn_display_toggles(),
        vec![WornDisplay::Helm],
        "the click is a CMSG_TOGGLE_HELM intent, not a stored value"
    );
    assert!(
        s.take_cvar_changes().is_empty(),
        "an API row must not touch the CVar table"
    );
    assert!(
        !s.eval::<bool>("return ShowingHelm() and true or false")
            .unwrap(),
        "the getter follows the click at once — the server has not answered yet"
    );
    assert!(
        s.eval::<bool>("return ShowingCloak() and true or false")
            .unwrap(),
        "and the other slot is a different bit"
    );

    // The read is a re-ask, not a remembered string: leave the page and come back.
    s.run("OptionsFrameCategoryListRowAudio:Click()").unwrap();
    s.run("OptionsFrameCategoryListRowInterface:Click()")
        .unwrap();
    assert!(
        !s.eval::<bool>(
            "return OptionsFrameContainerBodyInterfaceRowShowHelmCheck:GetChecked() \
             and true or false"
        )
        .unwrap(),
        "the revisit re-asks the getter"
    );

    // The wire is the truth: a descriptor edge that disagrees wins over the optimistic belief.
    s.set_worn_display(true, true);
    s.run("OptionsFrameCategoryListRowInterface:Click()")
        .unwrap();
    assert!(
        s.eval::<bool>(
            "return OptionsFrameContainerBodyInterfaceRowShowHelmCheck:GetChecked() \
             and true or false"
        )
        .unwrap(),
        "the server said the helm is shown, so the row says so"
    );
    assert!(s.errors().is_empty(), "script errors: {:?}", s.errors());
}

/// Defaults on an API row: both boxes go back to shown, and the flip is sent **only** for the one
/// that was actually off — the setter is a *set* over a wire verb that is a blind *toggle*, so a
/// no-op default must not queue a packet that would turn the preference on its head.
#[test]
fn defaults_sends_a_flip_only_for_the_row_that_moved() {
    let mut s = interface_harness();
    s.run("ShowUIPanel(OptionsFrame)").unwrap();
    s.run("OptionsFrameCategoryListRowInterface:Click()")
        .unwrap();
    s.run("OptionsFrameContainerBodyInterfaceRowShowCloakCheck:Click()")
        .unwrap();
    let _ = s.take_worn_display_toggles();
    assert!(!s
        .eval::<bool>("return ShowingCloak() and true or false")
        .unwrap());

    s.run("OptionsFrameContainerDefaults:Click()").unwrap();
    assert_eq!(
        s.take_worn_display_toggles(),
        vec![WornDisplay::Cloak],
        "only the cloak had moved"
    );
    assert!(s
        .eval::<bool>("return ShowingCloak() and true or false")
        .unwrap());
    assert!(s
        .eval::<bool>("return ShowingHelm() and true or false")
        .unwrap());
    assert!(s.errors().is_empty(), "script errors: {:?}", s.errors());
}

/// Defaults here restores **our** shipped assignments, which is the visible payoff of capturing the
/// default at OnLoad instead of restating it (1134 §1): `QUEST_FADING_DISABLE` ships `"1"` by
/// direction (2026-07-17) where 1.12's own table hand-writes `default = "0"`. The page walks back
/// to the value QuestFrame.xml actually assigns — there is no second copy to disagree with it.
#[test]
fn defaults_on_the_interface_page_restores_our_pin_not_the_references() {
    let s = interface_harness();
    s.run("ShowUIPanel(OptionsFrame)").unwrap();
    s.run("OptionsFrameCategoryListRowInterface:Click()")
        .unwrap();
    s.run(
        "OptionsFrameContainerBodyInterfaceRowInstantQuestTextCheck:Click() \
         OptionsFrameContainerBodyInterfaceRowNewbieTipsCheck:Click()",
    )
    .unwrap();
    assert_eq!(
        s.eval::<String>("return QUEST_FADING_DISABLE").unwrap(),
        "0"
    );
    assert_eq!(s.eval::<String>("return SHOW_NEWBIE_TIPS").unwrap(), "0");

    s.run("OptionsFrameContainerDefaults:Click()").unwrap();
    assert_eq!(
        s.eval::<String>("return QUEST_FADING_DISABLE").unwrap(),
        "1",
        "back to OUR default, not the reference's \"0\""
    );
    assert_eq!(s.eval::<String>("return SHOW_NEWBIE_TIPS").unwrap(), "1");
    assert!(s
        .eval::<bool>(
            "return OptionsFrameContainerBodyInterfaceRowInstantQuestTextCheck:GetChecked() \
             and true or false"
        )
        .unwrap());
    assert!(s.errors().is_empty(), "script errors: {:?}", s.errors());
}

/// The point of the page: what it writes is remembered. The toggle lands in the saved-variables
/// text under the **reference's** global name — `AUTO_QUEST_WATCH`, which is why 1136 renamed our
/// `BENILLA_AUTO_QUEST_WATCH` onto it — and a fresh tree replaying that text comes up on the
/// player's choice instead of QuestLogFrame.xml's shipped one.
#[test]
fn what_the_interface_page_writes_survives_a_restart() {
    let s = interface_harness();
    s.run("ShowUIPanel(OptionsFrame)").unwrap();
    s.run("OptionsFrameCategoryListRowInterface:Click()")
        .unwrap();
    s.run("OptionsFrameContainerBodyInterfaceRowAutoQuestWatchCheck:Click()")
        .unwrap();

    let saved = s.saved_variables_text();
    assert!(
        saved.contains("AUTO_QUEST_WATCH = \"0\""),
        "the toggle is in the saved text under the reference's name:\n{saved}"
    );

    let fresh = interface_harness();
    assert_eq!(
        fresh.eval::<String>("return AUTO_QUEST_WATCH").unwrap(),
        "1"
    );
    fresh.run(&saved).unwrap();
    assert_eq!(
        fresh.eval::<String>("return AUTO_QUEST_WATCH").unwrap(),
        "0",
        "the saved value wins over the file-scope default"
    );
    fresh.run("ShowUIPanel(OptionsFrame)").unwrap();
    fresh
        .run("OptionsFrameCategoryListRowInterface:Click()")
        .unwrap();
    assert!(!fresh
        .eval::<bool>(
            "return OptionsFrameContainerBodyInterfaceRowAutoQuestWatchCheck:GetChecked() \
             and true or false"
        )
        .unwrap());
    assert!(
        fresh.errors().is_empty(),
        "script errors: {:?}",
        fresh.errors()
    );
}

/// **A saved value that has a SIDE EFFECT has to be applied when the chunk lands.** The whole UI's
/// XML runs before `benilla-config/saved-variables.lua` executes over it (1128), so every file-scope
/// consumer of a global ran against the *shipped* default: `CombatText_OnLoad` armed its six event
/// registrations from `SHOW_COMBAT_TEXT = "1"`, and nothing re-ran when the saved `"0"` replaced it.
/// The player's "off" came back on at every restart. 1.12 closes this with a hand-written ladder in
/// `UIOptionsFrame`'s `VARIABLES_LOADED` arm ("Option specific function calls", UIOptionsFrame.lua
/// l.204-220); we hold each side effect on its own row already, so the window runs them there.
#[test]
fn a_saved_switch_with_a_side_effect_is_applied_when_the_variables_land() {
    let mut s = combat_harness();
    // What the saved chunk does, verbatim: assign over the file-scope default, then the event.
    s.run("SHOW_COMBAT_TEXT = \"0\"").unwrap();
    s.fire_event("VARIABLES_LOADED", vec![]);

    s.fire_event(
        "COMBAT_TEXT_UPDATE",
        vec![
            benilla_ui::script::ScriptValue::Str("DAMAGE".into()),
            benilla_ui::script::ScriptValue::Str("17".into()),
        ],
    );
    assert!(
        s.eval::<bool>("return getn(COMBAT_TEXT_TO_ANIMATE) == 0")
            .unwrap(),
        "the saved-off master is armed at load: the registrations were never re-run"
    );
    assert!(s.errors().is_empty(), "script errors: {:?}", s.errors());
}

/// The **Buff Durations** row (decision 1139) — the first setting in this window whose value has a
/// consequence nothing re-derives on its own, and so the first to carry an `applyFunc`. The timer
/// text needs no hook (the bar re-decides it every frame), but the ROW PITCH is stated once: with
/// timers the buff bar's three rows sit 45px apart, without them 35px — the reference's own two
/// geometries (`BuffButtons_UpdatePositions`). The click has to move it, and so does the saved
/// value landing at load, which is what the VARIABLES_LOADED walk is for.
#[test]
fn the_buff_durations_row_repitches_the_bar_and_the_pitch_survives_a_restart() {
    let gap = |s: &mut UiScript| -> f64 {
        s.resolve();
        s.eval::<f64>("return BuffButton0:GetBottom() - BuffButton8:GetTop()")
            .unwrap()
    };

    let mut s = interface_harness();
    assert_eq!(s.eval::<String>("return SHOW_BUFF_DURATIONS").unwrap(), "1");
    assert!(
        (gap(&mut s) - 15.0).abs() < 1e-3,
        "the shipped default is the durations-SHOWN geometry: {}",
        gap(&mut s)
    );

    s.run("ShowUIPanel(OptionsFrame)").unwrap();
    s.run("OptionsFrameCategoryListRowInterface:Click()")
        .unwrap();
    assert!(s
        .eval::<bool>(
            "return OptionsFrameContainerBodyInterfaceRowBuffDurationsCheck:GetChecked() \
             and true or false"
        )
        .unwrap());

    s.run("OptionsFrameContainerBodyInterfaceRowBuffDurationsCheck:Click()")
        .unwrap();
    assert_eq!(s.eval::<String>("return SHOW_BUFF_DURATIONS").unwrap(), "0");
    assert!(
        (gap(&mut s) - 5.0).abs() < 1e-3,
        "the click closed the timer gutter: {}",
        gap(&mut s)
    );

    // Restart: the fresh tree comes up on the shipped geometry, the chunk replaces the value, and
    // VARIABLES_LOADED is what puts the bar where the value says.
    let saved = s.saved_variables_text();
    assert!(
        saved.contains("SHOW_BUFF_DURATIONS = \"0\""),
        "the switch is in the saved text:\n{saved}"
    );
    let mut fresh = interface_harness();
    fresh.run(&saved).unwrap();
    assert!(
        (gap(&mut fresh) - 15.0).abs() < 1e-3,
        "the chunk moved the variable, not the bar"
    );
    fresh.fire_event("VARIABLES_LOADED", vec![]);
    assert!(
        (gap(&mut fresh) - 5.0).abs() < 1e-3,
        "the apply walk re-derives the geometry from the saved value: {}",
        gap(&mut fresh)
    );
    assert!(
        fresh.errors().is_empty(),
        "script errors: {:?}",
        fresh.errors()
    );
}

/// **Every category in this window now leads somewhere** (decision 1139). Chat — which was called
/// `Social` until 1589 — was the last one
/// that opened onto an empty page, and the arc that started at 1134 — rows over the second store —
/// closes here: Controls, Interface, Action Bars, Combat, Chat, Nameplates, Graphics and Audio
/// all carry rows, and Keybindings runs its own machinery. A category added without a page fails
/// this, which is the point: the honest tree (0950) is now a property the test holds, not a
/// promise the reader has to check.
///
/// The Defaults guard is keyed on ROWS, not on the category being real, so it is pinned directly
/// rather than through a stand-in page — there is no longer one to borrow.
#[test]
fn the_defaults_button_is_armed_by_rows_not_by_a_category() {
    let s = harness();
    s.run("ShowUIPanel(OptionsFrame)").unwrap();

    let keys: Vec<String> = s
        .eval::<String>("return table.concat(OPTIONS_CATEGORY_KEYS, \",\")")
        .unwrap()
        .split(',')
        .map(str::to_string)
        .collect();
    assert_eq!(keys.len(), 9, "the nine 1.15.9 categories: {keys:?}");
    for key in &keys {
        let has_rows = s
            .eval::<bool>(&format!(
                "return OPTIONS_PAGE_ROWS[\"{key}\"] ~= nil and \
                 getn(OPTIONS_PAGE_ROWS[\"{key}\"]) > 0"
            ))
            .unwrap();
        assert!(
            has_rows || key == "Keybindings",
            "{key} opens onto nothing — every category leads somewhere since 1139"
        );
        s.run(&format!("OptionsFrameCategoryListRow{key}:Click()"))
            .unwrap();
        assert!(
            s.eval::<bool>("return OptionsFrameContainerDefaults:IsEnabled()")
                .unwrap(),
            "{key}: Defaults is live on a page that has something to reset"
        );
    }

    // And the guard itself: a key with no rows behind it leaves Defaults asleep.
    s.run("OptionsFrame_SelectCategory(\"NotACategory\")")
        .unwrap();
    assert!(
        !s.eval::<bool>("return OptionsFrameContainerDefaults:IsEnabled()")
            .unwrap(),
        "Defaults is dead when the selected page has no rows"
    );
    assert!(s.errors().is_empty(), "script errors: {:?}", s.errors());
}

/// The **Chat page**'s two bubble switches (decision 1139; the page was `Social` until 1589 grew
/// it into 1.12's own `CHAT_LABEL` box) — and the last category in
/// this window to stop opening onto nothing. Both are CVar rows: `chat_bubble.rs` transcribed the
/// client's `ChatBubbles`/`ChatBubblesParty` spawn gate faithfully in 0598 and then froze it at a
/// pair of `const bool`, so this is the action-bar lock's shape again — the knob had to become
/// real before the row could mean anything. The page reads the registered table on select, a
/// click queues the flag the host drains onto `BubbleConfig`, and the two are independent (the
/// client gates party lines on their own CVar, which is why party bubbles survive turning
/// say/yell bubbles off).
#[test]
fn the_chat_page_toggles_the_chat_bubble_cvars() {
    let mut s = audio_harness();
    s.set_cvar_host("ChatBubblesParty", "0");
    let mut s = harness_on(s);
    s.run("ShowUIPanel(OptionsFrame)").unwrap();
    s.run("OptionsFrameCategoryListRowChat:Click()").unwrap();

    assert!(s
        .eval::<bool>("return OptionsFrameContainerBodyChat:IsVisible()")
        .unwrap());
    assert!(s
        .eval::<bool>("return OptionsFrameContainerDefaults:IsEnabled()")
        .unwrap());
    // Read from the table, not from a restated default: bubbles on, party bubbles off.
    assert!(s
        .eval::<bool>("return OptionsFrameContainerBodyChatRowChatBubblesCheck:GetChecked()")
        .unwrap());
    assert!(!s
        .eval::<bool>("return OptionsFrameContainerBodyChatRowPartyChatBubblesCheck:GetChecked()")
        .unwrap());
    let _ = s.take_sounds();

    s.run("OptionsFrameContainerBodyChatRowPartyChatBubblesCheck:Click()")
        .unwrap();
    assert_eq!(
        s.take_cvar_changes(),
        vec![("ChatBubblesParty".to_string(), "1".to_string())]
    );
    assert!(s
        .take_sounds()
        .contains(&SoundRequest::KitName("igMainMenuOptionCheckBoxOn".into())));

    // Turning say/yell bubbles off writes only its own switch — party keeps the value above.
    s.run("OptionsFrameContainerBodyChatRowChatBubblesCheck:Click()")
        .unwrap();
    assert_eq!(
        s.take_cvar_changes(),
        vec![("ChatBubbles".to_string(), "0".to_string())]
    );
    assert!(s
        .eval::<bool>("return OptionsFrameContainerBodyChatRowPartyChatBubblesCheck:GetChecked()")
        .unwrap());

    // Defaults walks the page back to the registered pair — including the ChatBubblesParty "1"
    // that deliberately disagrees with the binary's registered "0" (the director's /p ask, 0598).
    s.run("OptionsFrameContainerDefaults:Click()").unwrap();
    assert!(s
        .eval::<bool>("return OptionsFrameContainerBodyChatRowChatBubblesCheck:GetChecked()")
        .unwrap());
    assert!(s
        .eval::<bool>("return OptionsFrameContainerBodyChatRowPartyChatBubblesCheck:GetChecked()")
        .unwrap());
    assert!(s.errors().is_empty(), "script errors: {:?}", s.errors());
}

/// The **Chat page**'s two new rows (decision 1589 — B246, "no chat section in options"), the two
/// that make it 1.12's `CHAT_LABEL` box rather than a two-row bubble page.
///
/// They are deliberately over *different stores*, and that is what this pins: **Remove Chat Hover
/// Delay** is a saved-variable global with an `applyFunc` (its consumer is a pair of constants
/// nothing re-reads per frame, so the write alone would change nothing), and **Detailed Loot
/// Information** is a CVar with none (the loot-roll composer reads it as each line is built —
/// 1136's rule for when a row needs one, seen from both sides on one page).
#[test]
fn the_chat_page_writes_the_hover_delay_global_and_the_loot_spam_cvar() {
    let mut s = chat_harness();
    s.run("ShowUIPanel(OptionsFrame)").unwrap();
    s.run("OptionsFrameCategoryListRowChat:Click()").unwrap();
    let _ = s.take_sounds();
    let _ = s.take_cvar_changes();

    // Read: the shipped values, off the two files that declare them — not restated here.
    assert_eq!(
        s.eval::<String>("return REMOVE_CHAT_DELAY").unwrap(),
        "0",
        "ChatFrame.xml's own file-scope value, and the reference's declared default"
    );
    assert!(!s
        .eval::<bool>("return OptionsFrameContainerBodyChatRowRemoveChatDelayCheck:GetChecked()")
        .unwrap());
    assert!(
        s.eval::<bool>("return OptionsFrameContainerBodyChatRowLootSpamCheck:GetChecked()")
            .unwrap(),
        "showLootSpam is registered \"1\" — the binary's own default"
    );

    // The hover-delay row: the write is the global, and the applyFunc is what makes it mean
    // something. Both fade constants collapse to zero — the reference's SetChatMouseOverDelay.
    assert_eq!(
        s.eval::<(f64, f64)>("return CHAT_TAB_SHOW_DELAY, CHAT_FRAME_FADE_TIME")
            .unwrap(),
        (0.2, 0.15)
    );
    s.run("OptionsFrameContainerBodyChatRowRemoveChatDelayCheck:Click()")
        .unwrap();
    assert_eq!(s.eval::<String>("return REMOVE_CHAT_DELAY").unwrap(), "1");
    assert_eq!(
        s.eval::<(f64, f64)>("return CHAT_TAB_SHOW_DELAY, CHAT_FRAME_FADE_TIME")
            .unwrap(),
        (0.0, 0.0),
        "the box appears the instant the cursor crosses it"
    );
    assert!(
        s.take_cvar_changes().is_empty(),
        "a saved-variable row reaches the CVar table not at all"
    );

    // …and back, which is the half a one-way applyFunc would break.
    s.run("OptionsFrameContainerBodyChatRowRemoveChatDelayCheck:Click()")
        .unwrap();
    assert_eq!(s.eval::<String>("return REMOVE_CHAT_DELAY").unwrap(), "0");
    assert_eq!(
        s.eval::<(f64, f64)>("return CHAT_TAB_SHOW_DELAY, CHAT_FRAME_FADE_TIME")
            .unwrap(),
        (0.2, 0.15)
    );

    // The loot-spam row: a plain CVar write, no applyFunc, nothing else on the page moved.
    s.run("OptionsFrameContainerBodyChatRowLootSpamCheck:Click()")
        .unwrap();
    assert_eq!(
        s.take_cvar_changes(),
        vec![("showLootSpam".to_string(), "0".to_string())]
    );
    assert!(s
        .eval::<bool>("return OptionsFrameContainerBodyChatRowChatBubblesCheck:GetChecked()")
        .unwrap());

    // Defaults walks the page back across BOTH stores in one click.
    s.run("OptionsFrameContainerDefaults:Click()").unwrap();
    assert_eq!(
        s.take_cvar_changes(),
        vec![("showLootSpam".to_string(), "1".to_string())],
        "only the row that had moved is written back"
    );
    assert_eq!(s.eval::<String>("return REMOVE_CHAT_DELAY").unwrap(), "0");
    assert!(s.errors().is_empty(), "script errors: {:?}", s.errors());
}

/// The saved *Remove Chat Hover Delay* survives a restart — the `applyFunc` runs at
/// `VARIABLES_LOADED`, which is the only thing that can re-collapse the fade constants after a
/// fresh VM has re-run `ChatFrame.xml`'s file-scope `"0"`.
#[test]
fn a_saved_hover_delay_is_applied_when_the_variables_land() {
    let s = chat_harness();
    // What the saved-variables chunk does: assign the global, then the window's VARIABLES_LOADED.
    s.run("REMOVE_CHAT_DELAY = \"1\"").unwrap();
    assert_eq!(
        s.eval::<(f64, f64)>("return CHAT_TAB_SHOW_DELAY, CHAT_FRAME_FADE_TIME")
            .unwrap(),
        (0.2, 0.15),
        "the bare assignment changes nothing on its own — that is why the row has an applyFunc"
    );
    s.run("OptionsFrame_ApplySavedSettings()").unwrap();
    assert_eq!(
        s.eval::<(f64, f64)>("return CHAT_TAB_SHOW_DELAY, CHAT_FRAME_FADE_TIME")
            .unwrap(),
        (0.0, 0.0)
    );
    assert!(s.errors().is_empty(), "script errors: {:?}", s.errors());
}

/// **Status Bar Text** (decision 1140) — the row that finally reaches `TextStatusBar.xml`. That
/// file has been transcribed whole since 1082, with a `CVAR_UPDATE` watcher and a `statusBarText`
/// read on every repaint, and nothing in the client could move the variable: `GetCVar` answered nil
/// for a key the host never registered, which reads as off. So the numerals were hover-only, with
/// no way to pin them.
///
/// The row is also the only one in this window carrying a `cvarEvent`, and this is what that buys:
/// the XP bar's numerals appear on the click, not on the next XP tick. The event is 1.12's own —
/// `SetCVar(cvar, value, index)`'s third argument, handed back as arg1 — which is why the token
/// here is the uppercase display name and not the CVar's own spelling.
#[test]
fn the_status_bar_text_row_pins_the_numerals_the_moment_it_is_clicked() {
    let mut s = interface_harness();
    // The bar needs a real span before it decides anything about its numerals (its update bails
    // on valueMax == 0 and hides the strip instead).
    s.set_player_xp(1000, 10000);
    s.run("this = MainMenuExpBar; MainMenuExpBar_Update()")
        .unwrap();
    // Shipped default: off, so the numerals only show while hovered.
    assert_eq!(
        s.eval::<String>("return GetCVar(\"statusBarText\")")
            .unwrap(),
        "0"
    );
    assert!(!s
        .eval::<bool>("return MainMenuBarExpText:IsShown()")
        .unwrap());

    s.run("ShowUIPanel(OptionsFrame)").unwrap();
    s.run("OptionsFrameCategoryListRowInterface:Click()")
        .unwrap();
    assert!(!s
        .eval::<bool>("return OptionsFrameContainerBodyInterfaceRowStatusTextCheck:GetChecked()")
        .unwrap());

    s.run("OptionsFrameContainerBodyInterfaceRowStatusTextCheck:Click()")
        .unwrap();
    assert_eq!(
        s.take_cvar_changes(),
        vec![("statusBarText".to_string(), "1".to_string())]
    );
    // No repaint, no XP tick — only the CVAR_UPDATE the third argument queued.
    s.tick(0.0);
    assert!(
        s.eval::<bool>("return MainMenuBarExpText:IsShown()")
            .unwrap(),
        "the watcher woke on the click, not on the next value change"
    );

    // And back off again, the same way.
    s.run("OptionsFrameContainerBodyInterfaceRowStatusTextCheck:Click()")
        .unwrap();
    s.tick(0.0);
    assert!(!s
        .eval::<bool>("return MainMenuBarExpText:IsShown()")
        .unwrap());
    assert!(s.errors().is_empty(), "script errors: {:?}", s.errors());
}

/// **Mouse Sensitivity** (decision 1140) — the Controls page's first slider, and the third frozen
/// constant this arc has unfrozen: the camera's radians-per-pixel rate was a `const` with no way
/// to reach it. 1.12's own row (`UIOptionsFrameSliders`' MOUSE_SENSITIVITY): 0.5 … 1.5 by 0.05,
/// a multiplier, so the registered default 1 is the shipped feel and the percent readout reads it
/// straight. The slider snaps to the reference's step and writes the CVar the host drains onto
/// `LookConfig::sensitivity`.
#[test]
fn the_mouse_sensitivity_slider_snaps_to_the_reference_step() {
    let mut s = audio_harness();
    s.set_cvar_host("mousespeed", "1.25");
    let mut s = harness_on(s);
    s.run("ShowUIPanel(OptionsFrame)").unwrap();
    s.run("OptionsFrameCategoryListRowControls:Click()")
        .unwrap();

    // Read from the table on select, with the era's rounded-percent readout.
    assert!(s
        .eval::<bool>(
            "return math.abs(OptionsFrameContainerBodyControlsRowMouseSpeedControlSlider:GetValue() \
             - 1.25) < 0.0001"
        )
        .unwrap());
    assert_eq!(
        s.eval::<String>(
            "return OptionsFrameContainerBodyControlsRowMouseSpeedControlValue:GetText()"
        )
        .unwrap(),
        "125%"
    );

    // A user move snaps to 0.05 and writes once.
    s.run("OptionsFrameContainerBodyControlsRowMouseSpeedControlSlider:SetValue(1.42)")
        .unwrap();
    assert_eq!(
        s.take_cvar_changes(),
        vec![("mousespeed".to_string(), "1.4".to_string())]
    );

    // Defaults walks it back to the neutral notch — the shipped feel, not the slider's floor.
    s.run("OptionsFrameContainerDefaults:Click()").unwrap();
    assert_eq!(
        s.eval::<String>("return GetCVar(\"mousespeed\")").unwrap(),
        "1"
    );
    assert_eq!(
        s.eval::<String>(
            "return OptionsFrameContainerBodyControlsRowMouseSpeedControlValue:GetText()"
        )
        .unwrap(),
        "100%"
    );
    assert!(s.errors().is_empty(), "script errors: {:?}", s.errors());
}

/// **Max Camera Distance** (decision 1140) — the fourth frozen constant, and the one with a wrinkle
/// worth pinning: 1.12 stores a FACTOR over `cameraDistanceMax`'s 15 yd base, so the value that
/// persists is `1.0 … 2.0` while the thing the player is choosing is a distance. The readout shows
/// the distance; the CVar carries the factor. Our default is the factor fully raised — the 30 yd
/// ceiling benilla has always had — where the reference's registrar ships 1.0.
#[test]
fn the_max_camera_distance_slider_stores_a_factor_and_reads_out_yards() {
    let mut s = harness_on(audio_harness());
    s.run("ShowUIPanel(OptionsFrame)").unwrap();
    s.run("OptionsFrameCategoryListRowControls:Click()")
        .unwrap();

    // The shipped ceiling, shown as what it buys.
    assert_eq!(
        s.eval::<String>(
            "return OptionsFrameContainerBodyControlsRowMaxCameraDistanceControlValue:GetText()"
        )
        .unwrap(),
        "30 yd"
    );

    // Down to the reference's own default: the factor is what persists, the yards are the label.
    s.run("OptionsFrameContainerBodyControlsRowMaxCameraDistanceControlSlider:SetValue(1.0)")
        .unwrap();
    assert_eq!(
        s.take_cvar_changes(),
        vec![("cameraDistanceMaxFactor".to_string(), "1".to_string())]
    );
    assert_eq!(
        s.eval::<String>(
            "return OptionsFrameContainerBodyControlsRowMaxCameraDistanceControlValue:GetText()"
        )
        .unwrap(),
        "15 yd",
        "vanilla's own out-of-box ceiling"
    );

    s.run("OptionsFrameContainerDefaults:Click()").unwrap();
    assert_eq!(
        s.eval::<String>("return GetCVar(\"cameraDistanceMaxFactor\")")
            .unwrap(),
        "2"
    );
    assert!(s.errors().is_empty(), "script errors: {:?}", s.errors());
}

/// **Camera Following Style** (decisions 1493/1502) — 1.12's `cameraSmoothStyle`, worn as a
/// Controls-page dropdown, and the setting that decides whether the camera returns to behind the
/// character at all. What is pinned here is the trap: the reference's own dropdown writes `1/2/3`,
/// but the ENGINE's tables are indexed `0 = Never · 1 = Smart · 2 = Always`, and `3` is not a style
/// — the validator accepts it while the terrain-tilt consumer indexes off the end of its table
/// (wow-re `camera-smooth-style.md` §2/§4). So our entries carry the engine's numbers in the
/// reference's display order, a stray `3` still reads as Never rather than as the numerically
/// nearest "Always", and the plate follows the SELECTION the way that dropdown's own does.
#[test]
fn the_camera_following_style_dropdown_carries_the_engine_enum_and_plate() {
    let mut s = harness_on(audio_harness());
    s.run("ShowUIPanel(OptionsFrame)").unwrap();
    s.run("OptionsFrameCategoryListRowControls:Click()")
        .unwrap();

    // The registrar default is the reference's, and it is what the director asked to ship.
    assert_eq!(
        s.eval::<String>(
            "return OptionsFrameContainerBodyControlsRowCameraFollowStyleDropdownText:GetText()"
        )
        .unwrap(),
        "Smart"
    );
    assert_eq!(
        s.eval::<String>(
            "return OptionsFrameContainerBodyControlsRowCameraFollowStyleLabel:GetText()"
        )
        .unwrap(),
        "Camera Following Style"
    );
    assert_eq!(
        s.eval::<String>("return OptionsFrameContainerBodyControlsRowCameraFollowStyle.tip")
            .unwrap(),
        "OPTION_TOOLTIP_CAMERA1"
    );
    assert!(
        s.take_cvar_changes().is_empty(),
        "reading the table on select must not write it back"
    );

    // The list is the reference dropdown's, entry for entry and in its order.
    s.run("OptionsFrameContainerBodyControlsRowCameraFollowStyleDropdownButton:Click()")
        .unwrap();
    assert_eq!(
        s.eval::<f64>("return DropDownList1.numButtons").unwrap(),
        3.0
    );
    assert_eq!(
        s.eval::<String>(
            "return DropDownList1Button1:GetText() .. \",\" .. DropDownList1Button2:GetText() \
             .. \",\" .. DropDownList1Button3:GetText()"
        )
        .unwrap(),
        "Smart,Always,Never"
    );
    assert!(s
        .eval::<bool>("return DropDownList1Button1Check:IsVisible()")
        .unwrap());

    // Never stores "0" — the engine's own index, not the "3" the reference's dropdown writes —
    // and the row's plate becomes Never's own description.
    s.run("DropDownList1Button3:Click()").unwrap();
    assert_eq!(
        s.take_cvar_changes(),
        vec![("cameraSmoothStyle".to_string(), "0".to_string())]
    );
    assert_eq!(
        s.eval::<String>(
            "return OptionsFrameContainerBodyControlsRowCameraFollowStyleDropdownText:GetText()"
        )
        .unwrap(),
        "Never"
    );
    assert_eq!(
        s.eval::<String>("return OptionsFrameContainerBodyControlsRowCameraFollowStyle.tip")
            .unwrap(),
        "OPTION_TOOLTIP_CAMERA3",
        "the plate follows the selection, like the reference dropdown's own"
    );

    // Always is the middle entry and stores "2".
    s.run("OptionsFrameContainerBodyControlsRowCameraFollowStyleDropdownButton:Click()")
        .unwrap();
    s.run("DropDownList1Button2:Click()").unwrap();
    assert_eq!(
        s.take_cvar_changes(),
        vec![("cameraSmoothStyle".to_string(), "2".to_string())]
    );

    // A config written by a REAL 1.12 client says "3" for Never. It must not display as the
    // numerically nearest stop — which is Always, the opposite of what it means.
    s.set_cvar_host("cameraSmoothStyle", "3");
    s.run("OptionsFrameCategoryListRowAudio:Click(); OptionsFrameCategoryListRowControls:Click()")
        .unwrap();
    assert_eq!(
        s.eval::<String>(
            "return OptionsFrameContainerBodyControlsRowCameraFollowStyleDropdownText:GetText()"
        )
        .unwrap(),
        "Never",
        "the reference dropdown's own stray value still means Never"
    );
    assert!(
        s.take_cvar_changes().is_empty(),
        "displaying a stray value must not write it back"
    );

    // Defaults walks it back to Smart.
    s.run("OptionsFrameContainerDefaults:Click()").unwrap();
    assert_eq!(
        s.eval::<String>("return GetCVar(\"cameraSmoothStyle\")")
            .unwrap(),
        "1"
    );
    assert_eq!(
        s.eval::<String>(
            "return OptionsFrameContainerBodyControlsRowCameraFollowStyleDropdownText:GetText()"
        )
        .unwrap(),
        "Smart"
    );
    assert!(s.errors().is_empty(), "script errors: {:?}", s.errors());
}

/// The **Action Bars page's five switches** (decision 1500) — the four bar toggles and the grid
/// option, on ONE page over TWO different stores, which is the whole point of the test.
///
/// The four bar rows are API (`func`) rows: there is nothing local to save, because the preference
/// is four bits of this character's server-side `PLAYER_FIELD_BYTES` byte 2. A click writes the
/// live Lua global, re-derives the bars and re-sends the whole byte — with **four** arguments, the
/// binding's verified arity. Always Show ActionBars is a saved-variable row instead, and NOT
/// because someone preferred it: the same binding silently drops the fifth argument the reference
/// passes it, so that switch has no server store to write.
///
/// The end-to-end teeth are the real bars moving in the same VM — the row's write reaches
/// `MultiActionBar_Update`, which reaches `UIParent_ManageFramePositions`.
#[test]
fn the_action_bars_page_toggles_the_real_bars() {
    let mut s = actionbars_harness();
    s.run("ShowUIPanel(OptionsFrame)").unwrap();
    s.run("OptionsFrameCategoryListRowActionBars:Click()")
        .unwrap();

    let box_of = |row: &str| format!("OptionsFrameContainerBodyActionBars{row}Check");
    let checked = |s: &UiScript, row: &str| {
        s.eval::<bool>(&format!(
            "return {}:GetChecked() and true or false",
            box_of(row)
        ))
        .unwrap()
    };
    let shown =
        |s: &UiScript, bar: &str| s.eval::<bool>(&format!("return {bar}:IsShown()")).unwrap();

    // Read: every switch ships OFF, and so does every bar.
    for row in [
        "RowMultiBar1",
        "RowMultiBar2",
        "RowMultiBar3",
        "RowMultiBar4",
        "RowAlwaysShowMultibars",
    ] {
        assert!(!checked(&s, row), "{row} ships unticked");
    }
    for bar in [
        "MultiBarBottomLeft",
        "MultiBarBottomRight",
        "MultiBarRight",
        "MultiBarLeft",
    ] {
        assert!(!shown(&s, bar), "{bar} ships down");
    }

    // Bar 4's row is DEAD while bar 3's is unticked — MultiBarLeft cannot stand without
    // MultiBarRight (the reference's own rule for this pair, UIOptionsFrame.lua l.722-726).
    assert!(
        !s.eval::<bool>(&format!("return {}:IsEnabled()", box_of("RowMultiBar4")))
            .unwrap(),
        "Show Right ActionBar 2 is disabled until Show Right ActionBar is on"
    );

    // The write: a click raises the bar, writes the global as the number 1, and sends the byte.
    let _ = s.take_cvar_changes();
    s.run(&format!("{}:Click()", box_of("RowMultiBar1")))
        .unwrap();
    assert!(shown(&s, "MultiBarBottomLeft"), "the row reached the bar");
    assert_eq!(s.eval::<i64>("return SHOW_MULTI_ACTIONBAR_1").unwrap(), 1);
    assert_eq!(
        s.take_action_bar_toggle_sends(),
        vec![0x01],
        "one CMSG_SET_ACTIONBAR_TOGGLES carrying the whole byte"
    );
    assert!(
        s.take_cvar_changes().is_empty(),
        "an API row must not touch the CVar table"
    );

    // …and the managed bottom stack moved with it (CONTAINER_OFFSET_Y's bottomEither 27).
    assert_eq!(s.eval::<f64>("return CONTAINER_OFFSET_Y").unwrap(), 97.0);

    // Ticking bar 3 wakes bar 4's row; ticking bar 4 then brings MultiBarLeft up beside it.
    s.run(&format!("{}:Click()", box_of("RowMultiBar3")))
        .unwrap();
    assert!(
        s.eval::<bool>(&format!("return {}:IsEnabled()", box_of("RowMultiBar4")))
            .unwrap(),
        "bar 3 on wakes bar 4's row"
    );
    assert!(shown(&s, "MultiBarRight"));
    assert!(!shown(&s, "MultiBarLeft"), "bar 4 is still off");
    s.run(&format!("{}:Click()", box_of("RowMultiBar4")))
        .unwrap();
    assert!(shown(&s, "MultiBarLeft"));
    assert_eq!(
        s.take_action_bar_toggle_sends(),
        vec![0x05, 0x0d],
        "one packet per click — bars 1+3, then 1+3+4"
    );

    // Untick bar 3 and MultiBarLeft goes with it, even though bar 4's own flag is still set — the
    // conjunction is in MultiActionBar_Update, not in the row.
    s.run(&format!("{}:Click()", box_of("RowMultiBar3")))
        .unwrap();
    assert!(!shown(&s, "MultiBarRight"));
    assert!(!shown(&s, "MultiBarLeft"), "MultiBarLeft rides on bar 3");
    assert_eq!(s.eval::<i64>("return SHOW_MULTI_ACTIONBAR_4").unwrap(), 1);
    assert!(
        !s.eval::<bool>(&format!("return {}:IsEnabled()", box_of("RowMultiBar4")))
            .unwrap(),
        "…and its row goes back to sleep"
    );

    // The grid switch is the OTHER store: a saved-variable global, no packet, and an applyFunc
    // that opens every extra bar's empty wells.
    let _ = s.take_action_bar_toggle_sends();
    s.run(&format!("{}:Click()", box_of("RowAlwaysShowMultibars")))
        .unwrap();
    assert_eq!(
        s.eval::<String>("return ALWAYS_SHOW_MULTIBARS").unwrap(),
        "1",
        "a uvar row stores the panel's string"
    );
    assert!(
        s.take_action_bar_toggle_sends().is_empty(),
        "and sends NOTHING — the binding has no room for a fifth argument"
    );
    assert!(
        s.eval::<bool>("return MultiBarBottomLeftButton5:IsShown()")
            .unwrap(),
        "the applyFunc opened the empty wells"
    );

    // Defaults walks the whole page back: every bar down, the grid off, the lock unlocked.
    s.run("OptionsFrameContainerDefaults:Click()").unwrap();
    for bar in [
        "MultiBarBottomLeft",
        "MultiBarBottomRight",
        "MultiBarRight",
        "MultiBarLeft",
    ] {
        assert!(!shown(&s, bar), "{bar} back down");
    }
    assert_eq!(
        *s.take_action_bar_toggle_sends()
            .last()
            .expect("Defaults writes every bar row"),
        0,
        "the last packet Defaults sends is the empty byte"
    );
    assert_eq!(
        s.eval::<String>("return ALWAYS_SHOW_MULTIBARS").unwrap(),
        "0",
        "MultiBars.xml's own file-scope assignment IS the registered default"
    );
    assert_eq!(s.eval::<f64>("return CONTAINER_OFFSET_Y").unwrap(), 70.0);
    assert!(s.errors().is_empty(), "script errors: {:?}", s.errors());
}