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

//! The stock merchant window (`MerchantFrame.xml`), engine-only, fed a synthetic stock and purse.

use benilla_ui::script::{
    ContainerState, DressUpIntent, ExtractedQuad, ItemStatsHead, MerchantItem, MerchantState,
    QuadContent, ScriptValue, SoundRequest, UiScript,
};

use super::test_ui::{bag_open, load_ui as load_xml, BAG_UI};

/// Put a bag of `num_slots` empty slots in bag `id`: the stock `OpenBag` opens nothing for a
/// container with no slots (`ContainerFrame.lua:152-153`).
fn equip_bag(s: &mut UiScript, id: i64, name: &str, num_slots: u32) {
    s.set_container(
        id,
        Some(ContainerState {
            name: Some(name.into()),
            num_slots,
            slots: std::collections::HashMap::new(),
        }),
    );
}

/// The rect of the first bare-frame quad sized `w` by `h`; every frame emits one.
fn frame_rect(quads: &[ExtractedQuad], w: f32, h: f32) -> benilla_ui::layout::Rect {
    quads
        .iter()
        .find_map(|q| match &q.content {
            QuadContent::Frame => q
                .rect
                .filter(|r| (r.width() - w).abs() < 0.5 && (r.height() - h).abs() < 0.5),
            _ => None,
        })
        .unwrap_or_else(|| panic!("no bare-frame quad sized {w}x{h}"))
}

/// Two items and a purse: `MERCHANT_SHOW` opens the window in the left UIPanel slot, the rows and
/// coins paint, a right-click buys, and `MERCHANT_CLOSED` hides it and vacates the slot.
#[test]
fn shipped_merchant_frame_drives_end_to_end() {
    benilla_formats::wow_data_or_skip!();
    let mut s = UiScript::new().unwrap();
    s.set_screen_size(1024.0, 768.0);
    for f in super::test_ui::MERCHANT_UI {
        load_xml(&s, f);
    }
    // The census: every row is a container plus an `ItemButtonTemplate` button, and every price a
    // `SmallMoneyFrameTemplate` (`MerchantFrame.xml:4-115`).
    assert_eq!(
        load_xml(&s, "Interface\\FrameXML\\MerchantFrame.xml"),
        90,
        "the stock file's own shape — see the census note above"
    );

    s.resolve();
    let has_icon = |quads: &[ExtractedQuad], needle: &str| {
        quads.iter().any(|q| {
                matches!(&q.content, QuadContent::Texture { path: Some(p), .. } if p.contains(needle))
            })
    };
    assert!(
        !has_icon(&s.extract(), "INV_Drink_18"),
        "merchant window starts hidden"
    );

    s.set_money(12_345); // 1g 23s 45c
    s.set_merchant(Some(MerchantState {
        items: vec![
            MerchantItem {
                name: Some("Refreshing Spring Water".into()),
                texture: Some("Interface\\Icons\\INV_Drink_18".into()),
                price: 25,
                quantity: 1,
                num_available: -1,
                item_id: 159,
                stats: None,
                link: None,
                max_stack: Some(1),
            },
            MerchantItem {
                name: Some("Linen Bandage".into()),
                texture: Some("Interface\\Icons\\INV_Misc_Bandage_01".into()),
                price: 100,
                quantity: 1,
                num_available: 5,
                item_id: 1251,
                stats: None,
                link: None,
                max_stack: Some(1),
            },
        ],
        ..Default::default()
    }));
    s.fire_event("MERCHANT_SHOW", vec![]);
    assert!(s.errors().is_empty(), "script errors: {:?}", s.errors());

    assert!(s.eval::<bool>("return MerchantFrame:IsVisible()").unwrap());
    s.resolve();
    let quads = s.extract();
    assert!(has_icon(&quads, "INV_Drink_18"), "row 1 icon visible");
    assert!(
        has_icon(&quads, "INV_Misc_Bandage_01"),
        "row 2 icon visible"
    );
    let has_text = |t: &str| {
        quads
            .iter()
            .any(|q| matches!(&q.content, QuadContent::Text { text: Some(x), .. } if x == t))
    };
    assert!(has_icon(&quads, "UI-MoneyIcons"), "coin icons render");
    assert!(has_text("25"), "row 1 price shows the copper count '25'");
    assert!(
        has_text("23") && has_text("45"),
        "purse shows its silver/copper counts"
    );

    // A filled row's socket is bright, an empty one's 0.4 (`MerchantFrame.lua:108`, `:115`).
    let socket_colors: Vec<[f32; 4]> = quads
        .iter()
        .filter_map(|q| match &q.content {
            QuadContent::Texture {
                path: Some(p),
                color,
                ..
            } if p.contains("UI-EmptySlot") => Some(color.unwrap_or([1.0; 4])),
            _ => None,
        })
        .collect();
    // Rows 11 and 12 are hidden on the merchant tab (`MerchantFrame.lua:181-182`).
    assert_eq!(
        socket_colors.len(),
        11,
        "10 merchant rows + the buyback slot render their socket plate"
    );
    // Three bright: the merchant page never tints the buyback slot (`MerchantFrame.lua:133-152`).
    assert_eq!(
        socket_colors.iter().filter(|c| c[0] > 0.9).count(),
        3,
        "the 2 filled rows and the buyback slot keep the socket full-bright"
    );
    assert_eq!(
        socket_colors
            .iter()
            .filter(|c| (c[0] - 0.4).abs() < 0.01)
            .count(),
        8,
        "the 8 empty rows dim the socket to 0.4 (ref MerchantFrame.lua l.115)"
    );
    assert_eq!(
        quads
            .iter()
            .filter(
                |q| matches!(&q.content, QuadContent::Texture { path: Some(p), .. }
                    if p.contains("UI-Merchant-LabelSlots"))
            )
            .count(),
        11,
        "10 row label plates + the buyback slot's render"
    );

    // `SetLeftFrame` seats the window at TOPLEFT 0, -104 (`UIParent.lua:818`): top at 768 - 104.
    let win = frame_rect(&quads, 384.0, 512.0);
    assert_eq!(
        (win.left, win.top),
        (0.0, 664.0),
        "merchant window landed at the left slot (TOPLEFT UIParent, 0, -104)"
    );

    // The four quadrants, each pinned to its corner, whole texture (`MerchantFrame.xml:146-177`).
    let quad_of = |needle: &str| {
        quads
            .iter()
            .find(|q| {
                matches!(&q.content, QuadContent::Texture { path: Some(p), .. }
                        if p.contains(needle))
            })
            .unwrap_or_else(|| panic!("no texture quad for {needle}"))
    };
    let quad_rect = |needle: &str, w: f32, h: f32| {
        let q = quad_of(needle);
        assert!(
            matches!(
                &q.content,
                QuadContent::Texture {
                    tex_coords: None,
                    ..
                }
            ),
            "{needle} quadrant samples its whole texture (no TexCoords)"
        );
        let r = q.rect.unwrap_or_else(|| panic!("no rect for {needle}"));
        assert!(
            (r.width() - w).abs() < 0.5 && (r.height() - h).abs() < 0.5,
            "{needle} is {w}×{h}, got {}×{}",
            r.width(),
            r.height()
        );
        r
    };
    let tl = quad_rect("UI-Merchant-TopLeft", 256.0, 256.0);
    assert_eq!(
        (tl.left, tl.top),
        (win.left, win.top),
        "TopLeft quadrant pinned to the window's TOPLEFT"
    );
    let tr = quad_rect("UI-Merchant-TopRight", 128.0, 256.0);
    assert_eq!(
        (tr.right, tr.top),
        (win.right, win.top),
        "TopRight quadrant pinned to the window's TOPRIGHT"
    );
    let bl = quad_rect("UI-Merchant-BotLeft", 256.0, 256.0);
    assert_eq!(
        (bl.left, bl.bottom),
        (win.left, win.bottom),
        "BotLeft quadrant pinned to the window's BOTTOMLEFT"
    );
    let br = quad_rect("UI-Merchant-BotRight", 128.0, 256.0);
    assert_eq!(
        (br.right, br.bottom),
        (win.right, win.bottom),
        "BotRight quadrant pinned to the window's BOTTOMRIGHT"
    );

    let tex_rect = |needle: &str| {
        quads
            .iter()
            .find(|q| {
                matches!(&q.content, QuadContent::Texture { path: Some(p), .. }
                        if p.contains(needle))
            })
            .and_then(|q| q.rect)
            .unwrap_or_else(|| panic!("no texture quad for {needle}"))
    };
    let text_rect = |t: &str| {
        quads
            .iter()
            .find(|q| matches!(&q.content, QuadContent::Text { text: Some(x), .. } if x == t))
            .and_then(|q| q.rect)
            .unwrap_or_else(|| panic!("no text quad for {t:?}"))
    };

    let icon_rect = tex_rect("INV_Drink_18");
    assert!(
        (icon_rect.width() - 37.0).abs() < 0.5 && (icon_rect.height() - 37.0).abs() < 0.5,
        "row-left icon is a 37px square, got {}×{}",
        icon_rect.width(),
        icon_rect.height()
    );

    // The name sits above the price (`MerchantFrame.xml:34-45`, `:99-106`); rects are y-up.
    let name_rect = text_rect("Refreshing Spring Water");
    let price_rect = text_rect("25");
    let overlap = name_rect.left < price_rect.right
        && price_rect.left < name_rect.right
        && name_rect.bottom < price_rect.top
        && price_rect.bottom < name_rect.top;
    assert!(
        !overlap,
        "name {name_rect:?} must not overlap price {price_rect:?}"
    );
    assert!(
        name_rect.bottom >= price_rect.top,
        "name {name_rect:?} sits above price {price_rect:?}"
    );

    // A right-click buys; a plain left-click is `PickupMerchantItem` (`MerchantFrame.lua:329`).
    let (cx, cy) = (
        (icon_rect.left + icon_rect.right) * 0.5,
        (icon_rect.bottom + icon_rect.top) * 0.5,
    );
    s.mouse_button(cx, cy, "LeftButton", true);
    s.mouse_button(cx, cy, "LeftButton", false);
    assert!(
        s.take_merchant_buys().is_empty(),
        "left-click does not buy (pickup pending the cursor arc)"
    );
    s.mouse_button(cx, cy, "RightButton", true);
    s.mouse_button(cx, cy, "RightButton", false);
    assert_eq!(s.take_merchant_buys(), vec![(1, 1)]);

    s.fire_event("MERCHANT_CLOSED", vec![]);
    s.resolve();
    assert!(
        !has_icon(&s.extract(), "INV_Drink_18"),
        "MERCHANT_CLOSED hides the window"
    );
    assert!(
        s.eval::<bool>("return GetLeftFrame() == nil").unwrap(),
        "HideUIPanel vacated the left slot"
    );
    assert!(s.errors().is_empty(), "script errors: {:?}", s.errors());
}

/// The window's OnShow plays `igCharacterInfoOpen` and its OnHide `igCharacterInfoClose`
/// (`MerchantFrame.xml:721`, `:714`); nothing plays at load, where the frame starts hidden.
#[test]
fn merchant_show_hide_plays_open_and_close_kits() {
    benilla_formats::wow_data_or_skip!();
    let mut s = UiScript::new().unwrap();
    s.set_screen_size(1024.0, 768.0);
    for f in super::test_ui::MERCHANT_UI {
        load_xml(&s, f);
    }
    load_xml(&s, "ScrollTemplates.xml"); // our scroll kits
    load_xml(&s, "Interface\\FrameXML\\MerchantFrame.xml");

    assert!(
        s.take_sounds().is_empty(),
        "no sound at load (never transitions)"
    );

    s.set_money(0);
    s.set_merchant(Some(MerchantState::default()));
    s.fire_event("MERCHANT_SHOW", vec![]);
    assert!(s.errors().is_empty(), "script errors: {:?}", s.errors());
    assert_eq!(
        s.take_sounds(),
        vec![SoundRequest::KitName("igCharacterInfoOpen".into())],
        "opening the vendor window plays igCharacterInfoOpen"
    );

    s.fire_event("MERCHANT_CLOSED", vec![]);
    assert!(s.errors().is_empty(), "script errors: {:?}", s.errors());
    assert_eq!(
        s.take_sounds(),
        vec![SoundRequest::KitName("igCharacterInfoClose".into())],
        "closing the vendor window plays igCharacterInfoClose"
    );
}

/// `MerchantFrame_OnShow` calls `OpenBackpack` before the window's own sound
/// (`MerchantFrame.lua:35`), so the bag's kit (`ContainerFrame.lua:140`, `:120`) leads each pair.
#[test]
fn vendor_open_opens_the_backpack_and_layers_the_sound() {
    let _data = benilla_formats::wow_data_or_skip!();
    let mut s = UiScript::new().unwrap();
    s.set_screen_size(1024.0, 768.0);
    for file in BAG_UI {
        load_xml(&s, file);
    }
    load_xml(&s, "ScrollTemplates.xml"); // our scroll kits
    load_xml(&s, "Interface\\FrameXML\\CharacterFrameTemplates.xml");
    load_xml(&s, "Interface\\FrameXML\\MerchantFrame.xml");
    s.set_money(0);
    equip_bag(&mut s, 0, "Backpack", 16);
    let _ = s.take_sounds(); // ignore anything from load (frames are hidden; nothing should)

    s.set_merchant(Some(MerchantState::default()));
    s.fire_event("MERCHANT_SHOW", vec![]);
    assert!(s.errors().is_empty(), "script errors: {:?}", s.errors());
    assert_eq!(
        s.take_sounds(),
        vec![
            SoundRequest::KitName("igBackPackOpen".into()),
            SoundRequest::KitName("igCharacterInfoOpen".into()),
        ],
        "vendor open opens the backpack (bag kit) then plays its own panel kit"
    );
    assert!(bag_open(&s, 0), "the backpack is open alongside the vendor");

    s.fire_event("MERCHANT_CLOSED", vec![]);
    assert!(s.errors().is_empty(), "script errors: {:?}", s.errors());
    assert_eq!(
        s.take_sounds(),
        vec![
            SoundRequest::KitName("igBackPackClose".into()),
            SoundRequest::KitName("igCharacterInfoClose".into()),
        ],
        "vendor close closes the backpack it opened, both close kits play"
    );
    assert!(!bag_open(&s, 0), "…and the window goes with it");
}

/// A bag the player already had open stays open when the vendor closes: the was-open memory, per
/// bag in `BENILLA_BAG_WAS_OPEN` as in the stock `backpackWasOpen` (`ContainerFrame.lua:198-201`).
#[test]
fn vendor_leaves_an_already_open_backpack_alone() {
    let _data = benilla_formats::wow_data_or_skip!();
    let mut s = UiScript::new().unwrap();
    s.set_screen_size(1024.0, 768.0);
    for file in BAG_UI {
        load_xml(&s, file);
    }
    load_xml(&s, "ScrollTemplates.xml"); // our scroll kits
    load_xml(&s, "Interface\\FrameXML\\CharacterFrameTemplates.xml");
    load_xml(&s, "Interface\\FrameXML\\MerchantFrame.xml");
    s.set_money(0);
    equip_bag(&mut s, 0, "Backpack", 16);

    s.run("MainMenuBarBackpackButton:Click()").unwrap();
    assert!(bag_open(&s, 0), "fixture: the player's own bag is up first");
    let _ = s.take_sounds();
    s.set_merchant(Some(MerchantState::default()));
    s.fire_event("MERCHANT_SHOW", vec![]);
    assert_eq!(
        s.take_sounds(),
        vec![SoundRequest::KitName("igCharacterInfoOpen".into())],
        "bag already open → only the panel kit on vendor open"
    );

    s.fire_event("MERCHANT_CLOSED", vec![]);
    assert_eq!(
        s.take_sounds(),
        vec![SoundRequest::KitName("igCharacterInfoClose".into())],
        "the pre-opened bag is left open → only the panel close kit"
    );
    assert!(
        bag_open(&s, 0),
        "the player's own open bag survives the vendor closing"
    );
}

/// Deviation: the vendor opens every equipped bag, not only the backpack as the stock
/// `OpenBackpack` does, so every bag is up to sell from. `ContainerFrameAdapters.xml` replaces the
/// verb after the stock file loads; with the stock body live, bag 2 would not open.
#[test]
fn vendor_opens_and_closes_all_equipped_bags() {
    let _data = benilla_formats::wow_data_or_skip!();
    let mut s = UiScript::new().unwrap();
    s.set_screen_size(1024.0, 768.0);
    for file in BAG_UI {
        load_xml(&s, file);
    }
    load_xml(&s, "ScrollTemplates.xml"); // our scroll kits
    load_xml(&s, "Interface\\FrameXML\\CharacterFrameTemplates.xml");
    load_xml(&s, "Interface\\FrameXML\\MerchantFrame.xml");
    s.set_money(0);
    equip_bag(&mut s, 0, "Backpack", 16);
    equip_bag(&mut s, 2, "Small Pouch", 6);

    s.set_merchant(Some(MerchantState::default()));
    s.fire_event("MERCHANT_SHOW", vec![]);
    assert!(s.errors().is_empty(), "script errors: {:?}", s.errors());
    assert!(bag_open(&s, 0), "backpack opens");
    assert!(bag_open(&s, 2), "the equipped bag opens with the vendor");
    assert!(
        !bag_open(&s, 1) && !bag_open(&s, 3) && !bag_open(&s, 4),
        "an unequipped slot has no container, so nothing opens for it"
    );

    s.fire_event("MERCHANT_CLOSED", vec![]);
    assert!(s.errors().is_empty(), "script errors: {:?}", s.errors());
    assert!(
        !bag_open(&s, 0) && !bag_open(&s, 2),
        "every bag the vendor opened closes with it"
    );
}

/// Switching vendors is a close then an open, since `ShowUIPanel` returns early on a visible frame
/// (`UIParent.lua:650-652`). The close's OnHide queues a `CloseMerchant` the feed must consume, or
/// the drain would clear the vendor just reopened.
#[test]
fn merchant_switch_plays_close_then_open_and_queues_the_consumable_close() {
    benilla_formats::wow_data_or_skip!();
    let mut s = UiScript::new().unwrap();
    s.set_screen_size(1024.0, 768.0);
    for f in super::test_ui::MERCHANT_UI {
        load_xml(&s, f);
    }
    load_xml(&s, "ScrollTemplates.xml"); // our scroll kits
    load_xml(&s, "Interface\\FrameXML\\MerchantFrame.xml");

    s.set_money(0);
    s.set_merchant(Some(MerchantState::default()));
    s.fire_event("MERCHANT_SHOW", vec![]);
    let _ = s.take_sounds();
    let _ = s.take_merchant_close();

    s.set_merchant(Some(MerchantState::default()));
    s.fire_event("MERCHANT_CLOSED", vec![]);
    s.fire_event("MERCHANT_SHOW", vec![]);
    assert!(s.errors().is_empty(), "script errors: {:?}", s.errors());
    assert_eq!(
        s.take_sounds(),
        vec![
            SoundRequest::KitName("igCharacterInfoClose".into()),
            SoundRequest::KitName("igCharacterInfoOpen".into()),
        ],
        "switching vendors plays the close then the open kit"
    );
    assert!(
        s.take_merchant_close(),
        "the switch's MERCHANT_CLOSED queued a CloseMerchant intent — the feed must consume it so \
         the re-opened vendor is not cleared by the drain"
    );
}

/// Hovering a row's icon: the icon button's own 37px glow, a tooltip it owns at `ANCHOR_RIGHT`
/// (`MerchantFrame.xml:64`), and the item's stat head with no buy-price line.
#[test]
fn shipped_merchant_hover_scopes_highlight_and_anchors_item_tooltip() {
    benilla_formats::wow_data_or_skip!();
    let mut s = UiScript::new().unwrap();
    s.set_screen_size(1024.0, 768.0);
    // The stock tooltip sizes from its lines, so the harness needs a measurer.
    s.set_text_measurer(Box::new(super::FixedWidthFont(6.0)));
    for f in super::test_ui::MERCHANT_UI {
        load_xml(&s, f);
    }
    load_xml(&s, "Interface\\FrameXML\\UIDropDownMenu.xml");
    load_xml(&s, "ScrollTemplates.xml"); // our scroll kits
    load_xml(&s, "Interface\\FrameXML\\MerchantFrame.xml");

    s.set_merchant(Some(MerchantState {
        items: vec![
            MerchantItem {
                name: Some("Vendor Blade".into()),
                texture: Some("Interface\\Icons\\INV_Sword_04".into()),
                price: 8000,
                quantity: 1,
                num_available: -1,
                item_id: 2131,
                // An uncommon main-hand sword: 5.0–9.0 physical at 2600ms.
                stats: Some(ItemStatsHead {
                    quality: 2,
                    inventory_type: 21,
                    class: 2,
                    subclass: 7,
                    dmg_min: 5.0,
                    dmg_max: 9.0,
                    dmg_type: 0,
                    delay_ms: 2600,
                    armor: 0,
                    block: 0,
                    sell_price: 0,
                }),
                link: None,
                max_stack: Some(1),
            },
            MerchantItem {
                name: Some("Chipped Buckler".into()),
                texture: Some("Interface\\Icons\\INV_Shield_09".into()),
                price: 124,
                quantity: 1,
                num_available: -1,
                item_id: 2129,
                // A common shield: armor + block, no damage.
                stats: Some(ItemStatsHead {
                    quality: 1,
                    inventory_type: 14,
                    class: 4,
                    subclass: 6,
                    dmg_min: 0.0,
                    dmg_max: 0.0,
                    dmg_type: 0,
                    delay_ms: 0,
                    armor: 85,
                    block: 1,
                    sell_price: 0,
                }),
                link: None,
                max_stack: Some(1),
            },
        ],
        ..Default::default()
    }));
    s.fire_event("MERCHANT_SHOW", vec![]);
    assert!(s.errors().is_empty(), "script errors: {:?}", s.errors());
    s.resolve();

    let rect_of_tex = |quads: &[ExtractedQuad], needle: &str| {
        quads
            .iter()
            .find(|q| {
                matches!(&q.content, QuadContent::Texture { path: Some(p), .. } if p.contains(needle))
            })
            .and_then(|q| q.rect)
            .unwrap_or_else(|| panic!("no texture quad for {needle}"))
    };
    let has_text = |quads: &[ExtractedQuad], t: &str| {
        quads
            .iter()
            .any(|q| matches!(&q.content, QuadContent::Text { text: Some(x), .. } if x == t))
    };

    let quads = s.extract();
    assert!(
        !quads.iter().any(|q| {
            matches!(&q.content, QuadContent::Texture { path: Some(p), .. }
                if p.contains("ButtonHilight-Square"))
        }),
        "no highlight before hover"
    );
    assert!(!has_text(&quads, "Main Hand"), "no tooltip before hover");
    let sword_icon = rect_of_tex(&quads, "INV_Sword_04");

    // Hover the icon: a row is an inert container plus an icon-sized `$parentItemButton` that
    // takes the mouse (`MerchantFrame.xml:49`), so hovering the name shows nothing, as in 1.12.
    let (hx, hy) = (
        (sword_icon.left + sword_icon.right) * 0.5,
        (sword_icon.bottom + sword_icon.top) * 0.5,
    );
    s.mouse_move(hx, hy);
    assert!(s.errors().is_empty(), "OnEnter errors: {:?}", s.errors());
    s.resolve();
    let quads = s.extract();
    let hl = rect_of_tex(&quads, "ButtonHilight-Square");
    assert!(
        (hl.width() - 37.0).abs() < 0.5 && (hl.height() - 37.0).abs() < 0.5,
        "highlight is the 37px icon square, got {}×{}",
        hl.width(),
        hl.height()
    );
    assert_eq!(
        (hl.left, hl.top),
        (sword_icon.left, sword_icon.top),
        "highlight sits on the icon, not the row"
    );

    for line in [
        "Vendor Blade",
        "Main Hand",
        "5 - 9 Damage",
        "Speed 2.60",
        "(2.7 damage per second)",
    ] {
        assert!(has_text(&quads, line), "tooltip line {line:?} missing");
    }
    // No type word: this is the stat-head fallback of a hover whose full template is in flight,
    // and the word is `ItemSubClass.dbc`'s display name, which only the app resolves.
    assert!(!has_text(&quads, "Sword"), "the head carries no type word");
    // Two "Vendor Blade" quads: the row's gold name and the tooltip's uncommon-green header.
    let name_colors: Vec<[f32; 4]> = quads
        .iter()
        .filter_map(|q| match &q.content {
            QuadContent::Text {
                text: Some(t),
                color: Some(c),
                ..
            } if t == "Vendor Blade" => Some(*c),
            _ => None,
        })
        .collect();
    assert!(
        name_colors
            .iter()
            .any(|c| (c[0] - 0.12).abs() < 0.01 && (c[1] - 1.0).abs() < 0.01 && c[2].abs() < 0.01),
        "the tooltip name line is quality-green, got {name_colors:?}"
    );
    assert!(
        !quads.iter().any(|q| {
            matches!(&q.content, QuadContent::Text { text: Some(t), .. }
                if t.starts_with("Buy Price"))
        }),
        "the tooltip carries no buy-price line"
    );

    // `ANCHOR_RIGHT`: the tooltip's BOTTOMLEFT on the owner's TOPRIGHT, the owner the icon button.
    let (tip_left, tip_bottom): (f32, f32) = s
        .eval("return GameTooltip:GetLeft(), GameTooltip:GetBottom()")
        .unwrap();
    assert_eq!(
        (tip_left, tip_bottom),
        (sword_icon.right, sword_icon.top),
        "tooltip BOTTOMLEFT sits on the icon's TOPRIGHT"
    );

    let shield_icon = rect_of_tex(&quads, "INV_Shield_09");
    s.mouse_move(
        (shield_icon.left + shield_icon.right) * 0.5,
        (shield_icon.bottom + shield_icon.top) * 0.5,
    );
    assert!(
        s.errors().is_empty(),
        "row-2 OnEnter errors: {:?}",
        s.errors()
    );
    s.resolve();
    let quads = s.extract();
    for line in ["Chipped Buckler", "Off Hand", "85 Armor", "1 Block"] {
        assert!(
            has_text(&quads, line),
            "shield tooltip line {line:?} missing"
        );
    }
    assert!(!has_text(&quads, "Shield"), "the head carries no type word");
    assert!(!has_text(&quads, "Main Hand"), "row 1's tooltip cleared");

    s.mouse_move(1000.0, 10.0);
    s.resolve();
    let quads = s.extract();
    assert!(!has_text(&quads, "Off Hand"), "tooltip hidden on leave");
    assert!(
        !quads.iter().any(|q| {
            matches!(&q.content, QuadContent::Texture { path: Some(p), .. }
                if p.contains("ButtonHilight-Square"))
        }),
        "highlight gone on leave"
    );
    assert!(s.errors().is_empty(), "script errors: {:?}", s.errors());
}

/// The two tabs (`MerchantFrame.lua:57-64`): the merchant page has the buyback slot and repair
/// pair; the buyback page retitles the window and fills the rows from `GetBuybackItemInfo`.
#[test]
fn merchant_tabs_drive_buyback_page_and_repair_pair() {
    benilla_formats::wow_data_or_skip!();
    let mut s = UiScript::new().unwrap();
    s.set_screen_size(1024.0, 768.0);
    for f in super::test_ui::MERCHANT_UI {
        load_xml(&s, f);
    }
    load_xml(&s, "ScrollTemplates.xml"); // our scroll kits
    load_xml(&s, "Interface\\FrameXML\\MerchantFrame.xml");
    s.set_money(500);

    let buyback_item = |name: &str, price: u32| MerchantItem {
        name: Some(name.into()),
        texture: Some("Interface\\Icons\\INV_Misc_Cape_01".into()),
        price,
        quantity: 1,
        stats: Some(ItemStatsHead {
            quality: 1,
            ..Default::default()
        }),
        ..Default::default()
    };
    s.set_merchant(Some(MerchantState {
        items: vec![MerchantItem {
            name: Some("Refreshing Spring Water".into()),
            texture: Some("Interface\\Icons\\INV_Drink_18".into()),
            price: 25,
            quantity: 1,
            num_available: -1,
            item_id: 159,
            stats: None,
            link: None,
            max_stack: Some(1),
        }],
        buyback: vec![
            buyback_item("Bandit Cloak", 116),
            buyback_item("Cracked Sword", 20), // the latest sale: the merchant page's slot
        ],
        can_repair: true,
        repair_all_cost: 76,
    }));
    s.fire_event(
        "MERCHANT_SHOW",
        vec![ScriptValue::Str("Kurdram Stonehammer".into())],
    );
    assert!(s.errors().is_empty(), "show errors: {:?}", s.errors());

    // Merchant page: the latest sale in the buyback slot (`MerchantFrame.lua:133`), repair up.
    assert!(s
        .eval::<bool>("return MerchantBuyBackItemName:GetText() == 'Cracked Sword'")
        .unwrap());
    assert!(s
        .eval::<bool>(
            "return MerchantRepairAllButton:IsShown() and \
             MerchantRepairAllButton:IsEnabled() ~= 0"
        )
        .unwrap());
    assert!(s
        .eval::<bool>(
            "return not MerchantItem11:IsShown() and BuybackFrameTopLeft:IsShown() == nil"
        )
        .unwrap());

    // The slot's item button buys back the latest sale, slot 2 of 2.
    s.run("MerchantBuyBackItemItemButton:Click()").unwrap();
    assert_eq!(s.take_merchant_buybacks(), vec![2]);

    s.run("MerchantRepairAllButton:Click()").unwrap();
    assert!(s.take_repair_all());
    s.take_sounds();

    s.run("MerchantFrameTab2:Click()").unwrap();
    assert!(s.errors().is_empty(), "tab errors: {:?}", s.errors());
    assert!(s
        .eval::<bool>("return MerchantNameText:GetText() == 'Merchant Buyback'")
        .unwrap());
    assert!(s
        .eval::<bool>(
            "return MerchantItem1Name:GetText() == 'Bandit Cloak' \
             and MerchantItem2Name:GetText() == 'Cracked Sword'",
        )
        .unwrap());
    assert!(s
        .eval::<bool>(
            "return BuybackFrameTopLeft:IsShown() == 1 \
             and not MerchantBuyBackItem:IsShown() \
             and not MerchantRepairAllButton:IsShown()",
        )
        .unwrap());
    assert!(s
        .eval::<bool>(
            "return MerchantFrameTab2LeftDisabled:IsShown() == 1 \
             and MerchantFrameTab1LeftDisabled:IsShown() == nil",
        )
        .unwrap());

    // A buyback-page row click is `BuybackItem` (`MerchantFrame.lua:360`).
    s.run("MerchantItem1ItemButton:Click(\"LeftButton\")")
        .unwrap();
    assert_eq!(s.take_merchant_buybacks(), vec![1]);

    s.run("MerchantFrameTab1:Click()").unwrap();
    assert!(s
        .eval::<bool>(
            "return MerchantItem1Name:GetText() == 'Refreshing Spring Water' \
             and BuybackFrameTopLeft:IsShown() == nil",
        )
        .unwrap());
    assert!(s.errors().is_empty(), "script errors: {:?}", s.errors());
}

/// The tabs fit their labels once, in `<OnShow>` (`CharacterFrameTemplates.xml:77-80`), so the
/// measurer must answer synchronously, as the app's does.
#[test]
fn merchant_tabs_fit_their_labels() {
    benilla_formats::wow_data_or_skip!();
    /// `2 * $parentLeft:GetWidth()` (`UIPanelTemplates.lua:41`): the two 20-unit end slices.
    const SIDES: f64 = 40.0;
    let mut s = UiScript::new().unwrap();
    s.set_screen_size(1024.0, 768.0);
    s.set_text_measurer(Box::new(super::FixedWidthFont(6.0)));
    for f in super::test_ui::MERCHANT_UI {
        load_xml(&s, f);
    }
    load_xml(&s, "Interface\\FrameXML\\MerchantFrame.xml");
    s.set_money(0);
    s.set_merchant(Some(MerchantState::default()));
    s.fire_event("MERCHANT_SHOW", vec![ScriptValue::Str("Vendor".into())]);
    s.resolve();

    let (l1, l2, w1, w2, m1, m2): (f64, f64, f64, f64, f64, f64) = s
        .eval(
            "return MerchantFrameTab1Text:GetStringWidth(), MerchantFrameTab2Text:GetStringWidth(), \
             MerchantFrameTab1:GetWidth(), MerchantFrameTab2:GetWidth(), \
             MerchantFrameTab1MiddleDisabled:GetWidth(), MerchantFrameTab2Middle:GetWidth()",
        )
        .unwrap();
    assert!(l1 > 0.0 && l2 > 0.0, "both labels measured synchronously");
    assert_eq!(
        (w1, w2),
        (l1 + SIDES, l2 + SIDES),
        "text + 40, not the fixed 115"
    );
    assert_eq!((m1, m2), (l1, l2), "middle slices stretch to the text");
    assert!(s.errors().is_empty(), "script errors: {:?}", s.errors());
}

/// A hovered row arms the Buy cursor (UnableBuy when unaffordable, Inspect with ctrl held), which
/// the frame's OnUpdate re-arms every frame (`MerchantFrame.xml:726-741`); leaving clears it.
#[test]
fn shipped_merchant_frame_arms_the_buy_cursor_on_hover() {
    benilla_formats::wow_data_or_skip!();
    use benilla_ui::script::UiCursorMode;

    let mut s = UiScript::new().unwrap();
    s.set_screen_size(1024.0, 768.0);
    for f in super::test_ui::MERCHANT_UI {
        load_xml(&s, f);
    }
    load_xml(&s, "ScrollTemplates.xml"); // our scroll kits
    load_xml(&s, "Interface\\FrameXML\\MerchantFrame.xml");

    // A purse of 50c: row 1 (25c) is affordable, row 2 (100c) is not.
    s.set_money(50);
    s.set_merchant(Some(MerchantState {
        items: vec![
            MerchantItem {
                name: Some("Refreshing Spring Water".into()),
                texture: Some("Interface\\Icons\\INV_Drink_18".into()),
                price: 25,
                quantity: 1,
                num_available: -1,
                item_id: 159,
                stats: None,
                link: None,
                max_stack: Some(1),
            },
            MerchantItem {
                name: Some("Linen Bandage".into()),
                texture: Some("Interface\\Icons\\INV_Misc_Bandage_01".into()),
                price: 100,
                quantity: 1,
                num_available: 5,
                item_id: 1251,
                stats: None,
                link: None,
                max_stack: Some(1),
            },
        ],
        ..Default::default()
    }));
    s.fire_event("MERCHANT_SHOW", vec![]);
    s.resolve();
    assert_eq!(s.ui_cursor(), None, "no override before any hover");

    // The row button's inline `<OnEnter>`, fired as the engine fires it: `this` bound first.
    s.run("this = MerchantItem1ItemButton MerchantItem1ItemButton:GetScript(\"OnEnter\")() this = nil")
        .unwrap();
    s.tick(0.016);
    assert!(s.errors().is_empty(), "hover errors: {:?}", s.errors());
    assert_eq!(
        s.ui_cursor(),
        Some(UiCursorMode::Buy),
        "the coin arms over an affordable vendor item"
    );

    s.set_modifiers(false, true, false);
    s.tick(0.016);
    assert_eq!(
        s.ui_cursor(),
        Some(UiCursorMode::Inspect),
        "Ctrl-hover shows the inspect cursor"
    );
    s.set_modifiers(false, false, false);

    // OnLeave resets the cursor and clears `itemHover` (`MerchantFrame.xml:87-91`).
    s.run("this = MerchantItem1ItemButton MerchantItem1ItemButton:GetScript(\"OnLeave\")() this = nil")
        .unwrap();
    s.tick(0.016);
    assert_eq!(s.ui_cursor(), None, "leaving the row resets the cursor");

    s.run("this = MerchantItem2ItemButton MerchantItem2ItemButton:GetScript(\"OnEnter\")() this = nil")
        .unwrap();
    s.tick(0.016);
    assert_eq!(
        s.ui_cursor(),
        Some(UiCursorMode::UnableBuy),
        "an unaffordable vendor item grays the coin"
    );

    // Closing resets it with no OnLeave, from `MerchantFrame_OnHide` (`MerchantFrame.lua:54`).
    s.fire_event("MERCHANT_CLOSED", vec![]);
    s.tick(0.016);
    assert_eq!(s.ui_cursor(), None, "closing the window resets the cursor");
    assert!(s.errors().is_empty(), "script errors: {:?}", s.errors());
}

/// The trade partner's money (`TradeRecipientMoneyFrame`) shows a single digit, not "...".
#[test]
fn trade_recipient_money_renders_the_digit_not_ellipsis() {
    benilla_formats::wow_data_or_skip!();
    let mut s = UiScript::new().unwrap();
    s.set_screen_size(1024.0, 768.0);
    for f in super::test_ui::MERCHANT_UI {
        load_xml(&s, f);
    }
    load_xml(&s, "ScrollTemplates.xml"); // our scroll kits
    load_xml(&s, "Interface\\FrameXML\\MerchantFrame.xml"); // read by the stock bag-slot click
    load_xml(&s, "Interface\\FrameXML\\MoneyInputFrame.lua"); // for TradeFrame.xml's OnLoad
    load_xml(&s, "Interface\\FrameXML\\MoneyInputFrame.xml");
    load_xml(&s, "Interface\\FrameXML\\TradeFrame.xml");
    s.set_text_measurer(Box::new(super::FixedWidthFont(6.0)));

    let target = benilla_ui::script::TradeSideState {
        gold: 5, // a partner offering 5 copper → the recipient trio should show "5"
        ..Default::default()
    };
    s.set_trade(Some(benilla_ui::script::TradeState {
        target,
        ..Default::default()
    }));
    s.fire_event("TRADE_SHOW", vec![]);
    s.resolve();
    assert!(s.errors().is_empty(), "errors: {:?}", s.errors());
    let quads = s.extract();

    let has = |t: &str| {
        quads
            .iter()
            .any(|q| matches!(&q.content, QuadContent::Text { text: Some(x), .. } if x == t))
    };
    let texts: Vec<&str> = quads
        .iter()
        .filter_map(|q| match &q.content {
            QuadContent::Text { text: Some(x), .. } => Some(x.as_str()),
            _ => None,
        })
        .collect();
    assert!(
        !has("..."),
        "recipient money truncated to '...' (the bug). all text quads: {texts:?}"
    );
    assert!(
        has("5"),
        "recipient money shows the digit. all text quads: {texts:?}"
    );
}

/// The row's left-click fork (`MerchantFrame.lua:301-306`): ctrl dresses up the item and shift
/// posts its link, both through `GetMerchantItemLink`, and neither buys; a right-click buys unless
/// ctrl is held (`MerchantFrame.lua:332-333`).
#[test]
fn ctrl_and_shift_on_a_vendor_row_preview_and_post_without_buying() {
    benilla_formats::wow_data_or_skip!();
    const WATER_LINK: &str = "|cffffffff|Hitem:159:0:0:0|h[Refreshing Spring Water]|h|r";
    let mut s = UiScript::new().unwrap();
    s.set_screen_size(1024.0, 768.0);
    for f in super::test_ui::MERCHANT_UI {
        load_xml(&s, f);
    }
    for file in [
        r"Interface\FrameXML\UIParent.xml", // UIParent and UIParent.lua
        "ScrollTemplates.xml",              // our scroll kits
        "Interface\\FrameXML\\MerchantFrame.xml",
        "Interface\\FrameXML\\DressUpFrame.xml",
        "Interface\\FrameXML\\UIMenu.xml", // the kit ChatMenu/EmoteMenu/VoiceMacroMenu build from
        "Interface\\FrameXML\\GlobalStrings.lua",
        "Interface\\FrameXML\\BasicControls.xml",
        "Interface\\FrameXML\\ChatFrame.xml",
        "Interface\\FrameXML\\UIDropDownMenu.xml",
        // Not the panel templates or the dialogs, which MERCHANT_UI has: loading the stock money
        // kit's frames twice trips its global-named update.
        "Interface\\FrameXML\\FloatingChatFrame.xml",
    ] {
        load_xml(&s, file);
    }

    s.set_money(12_345);
    s.set_merchant(Some(MerchantState {
        items: vec![MerchantItem {
            name: Some("Refreshing Spring Water".into()),
            texture: Some("Interface\\Icons\\INV_Drink_18".into()),
            price: 25,
            quantity: 1,
            num_available: -1,
            item_id: 159,
            stats: None,
            // As `ui_merchant` builds it from the row's item template.
            link: Some(WATER_LINK.into()),
            max_stack: Some(1),
        }],
        ..Default::default()
    }));
    s.fire_event("MERCHANT_SHOW", vec![]);
    assert!(s.errors().is_empty(), "script errors: {:?}", s.errors());
    s.resolve();
    let quads = s.extract();
    let icon = quads
        .iter()
        .find(|q| {
            matches!(&q.content, QuadContent::Texture { path: Some(p), .. }
                    if p.contains("INV_Drink_18"))
        })
        .and_then(|q| q.rect)
        .expect("no row icon quad");
    let (x, y) = (
        (icon.left + icon.right) * 0.5,
        (icon.bottom + icon.top) * 0.5,
    );

    s.mouse_button(x, y, "RightButton", true);
    s.mouse_button(x, y, "RightButton", false);
    assert_eq!(
        s.take_merchant_buys(),
        vec![(1, 1)],
        "an unmodified right-click still buys"
    );

    s.set_modifiers(false, true, false);
    s.mouse_button(x, y, "RightButton", true);
    s.mouse_button(x, y, "RightButton", false);
    s.set_modifiers(false, false, false);
    assert!(
        s.take_merchant_buys().is_empty(),
        "a ctrl-held right-click must not buy (ref l.332-333)"
    );

    assert!(s.focus_editbox("ChatFrameEditBox"));
    s.set_modifiers(true, false, false);
    s.mouse_button(x, y, "LeftButton", true);
    s.mouse_button(x, y, "LeftButton", false);
    s.set_modifiers(false, false, false);
    assert_eq!(
        s.eval::<String>("return ChatFrameEditBox:GetText()")
            .unwrap(),
        WATER_LINK,
        "the vendor row's full escaped link landed in the chat box"
    );
    assert!(
        s.take_merchant_buys().is_empty(),
        "a shift-click must not also buy"
    );

    // Ctrl last: the dressing room takes a UIPanel slot and can move the vendor window.
    s.set_modifiers(false, true, false);
    s.mouse_button(x, y, "LeftButton", true);
    s.mouse_button(x, y, "LeftButton", false);
    s.set_modifiers(false, false, false);
    assert_eq!(
        s.take_dressup_intents(),
        vec![DressUpIntent::Dress, DressUpIntent::TryOn(159)],
        "re-dress first, then try the vendor's item on"
    );
    assert!(
        s.take_merchant_buys().is_empty(),
        "a ctrl-click must not also buy"
    );
    assert!(s.errors().is_empty(), "script errors: {:?}", s.errors());
}