justerm-core 0.17.0

//! Extended mouse-encoding tests (#28): the remaining real encodings on top of
//! #11's Default (X10) + SGR (?1006) — urxvt (?1015), UTF-8 (?1005), and
//! SGR-pixels (?1016). Driven feed(mode)→encode_mouse, asserting exact bytes.

use justerm_core::{Engine, Modifiers, MouseAction, MouseButton, MouseEvent};

fn press(col: usize, row: usize) -> MouseEvent {
    MouseEvent {
        button: Some(MouseButton::Left),
        action: MouseAction::Press,
        col,
        row,
        px: 0,
        py: 0,
        mods: Modifiers::empty(),
    }
}

/// A wheel event at `(col, row)`, button held as a press (wheel has no release).
fn wheel(button: MouseButton, col: usize, row: usize) -> MouseEvent {
    MouseEvent {
        button: Some(button),
        action: MouseAction::Press,
        col,
        row,
        px: 0,
        py: 0,
        mods: Modifiers::empty(),
    }
}

// #50 — wheel-tilt (horizontal scroll) buttons. xterm buttons 6/7 ride the same
// 64-base wheel group as up/down (64/65): left = Cb base 66, right = 67. Prior
// art: Alacritty reports the wheel as 64/65/66/67.

#[test]
fn wheel_left_encodes_sgr_cb_66() {
    let mut t = Engine::new(80, 24);
    t.feed(b"\x1b[?1000h\x1b[?1006h"); // normal tracking + SGR
    // wheel-left at (5,10) 0-based → Cb base 66, 1-based coords 6;11, press 'M'.
    assert_eq!(
        t.encode_mouse(wheel(MouseButton::WheelLeft, 5, 10))
            .unwrap(),
        b"\x1b[<66;6;11M"
    );
}

#[test]
fn wheel_right_encodes_sgr_cb_67() {
    let mut t = Engine::new(80, 24);
    t.feed(b"\x1b[?1000h\x1b[?1006h");
    assert_eq!(
        t.encode_mouse(wheel(MouseButton::WheelRight, 5, 10))
            .unwrap(),
        b"\x1b[<67;6;11M"
    );
}

#[test]
fn wheel_tilt_rides_the_x10_default_framing() {
    // The 64-base group flows through the X10 framing too: Cb 66 + 32 = 98 ('b'),
    // coords +32. Different code path from SGR (byte form, not decimal).
    let mut t = Engine::new(80, 24);
    t.feed(b"\x1b[?1000h"); // default X10 encoding
    assert_eq!(
        t.encode_mouse(wheel(MouseButton::WheelLeft, 5, 10))
            .unwrap(),
        vec![0x1b, b'[', b'M', 98, 38, 43]
    );
}

#[test]
fn modifier_bits_compose_with_a_wheel_button() {
    // Ctrl (+16) rides the same Cb as the button: 66 + 16 = 82.
    let mut t = Engine::new(80, 24);
    t.feed(b"\x1b[?1000h\x1b[?1006h");
    let mut e = wheel(MouseButton::WheelLeft, 5, 10);
    e.mods = Modifiers::CTRL;
    assert_eq!(t.encode_mouse(e).unwrap(), b"\x1b[<82;6;11M");
}

#[test]
fn wheel_release_emits_nothing() {
    // A wheel turn is a single press-like event; there is no release. A Release
    // action on a wheel button must not leak a stray report (in SGR it would have
    // emitted a bogus `m`, in X10 a release that loses button identity).
    let mut t = Engine::new(80, 24);
    t.feed(b"\x1b[?1000h\x1b[?1006h");
    let mut e = wheel(MouseButton::WheelUp, 5, 10);
    e.action = MouseAction::Release;
    assert!(
        t.encode_mouse(e).is_none(),
        "wheel has no release; must not emit a report",
    );
}

/// A press event with an arbitrary button. Unlike the wheel, the back/forward
/// and extra buttons are real buttons (press + release).
fn btn(button: MouseButton, col: usize, row: usize) -> MouseEvent {
    MouseEvent {
        button: Some(button),
        action: MouseAction::Press,
        col,
        row,
        px: 0,
        py: 0,
        mods: Modifiers::empty(),
    }
}

// #52 — additional buttons (the +128 group). xterm encodes back/forward (X11
// buttons 8/9) as Cb 128/129; gaming-mouse extras (10/11) via the same bit
// formula `(n & 3) | (n & 4 ? 64) | (n & 8 ? 128)`.

#[test]
fn back_button_encodes_sgr_cb_128() {
    let mut t = Engine::new(80, 24);
    t.feed(b"\x1b[?1000h\x1b[?1006h"); // normal tracking + SGR
    // back = X11 button 8 → Cb base 128; SGR press 'M'.
    assert_eq!(
        t.encode_mouse(btn(MouseButton::Back, 5, 10)).unwrap(),
        b"\x1b[<128;6;11M"
    );
}

#[test]
fn forward_button_encodes_sgr_cb_129() {
    let mut t = Engine::new(80, 24);
    t.feed(b"\x1b[?1000h\x1b[?1006h");
    assert_eq!(
        t.encode_mouse(btn(MouseButton::Forward, 5, 10)).unwrap(),
        b"\x1b[<129;6;11M"
    );
}

#[test]
fn other_buttons_encode_via_the_xterm_bit_formula() {
    // Gaming-mouse extras by X11 number: 10 → (10&3)|128 = 130, 11 → 131.
    let mut t = Engine::new(80, 24);
    t.feed(b"\x1b[?1000h\x1b[?1006h");
    assert_eq!(
        t.encode_mouse(btn(MouseButton::Other(10), 5, 10)).unwrap(),
        b"\x1b[<130;6;11M"
    );
    assert_eq!(
        t.encode_mouse(btn(MouseButton::Other(11), 5, 10)).unwrap(),
        b"\x1b[<131;6;11M"
    );
}

#[test]
fn back_button_has_a_real_release_unlike_the_wheel() {
    // Back/Forward/Other are real buttons: a Release reports (SGR 'm'), it is
    // not dropped the way a wheel turn's phantom release is (#50/#52).
    let mut t = Engine::new(80, 24);
    t.feed(b"\x1b[?1000h\x1b[?1006h");
    let mut e = btn(MouseButton::Back, 5, 10);
    e.action = MouseAction::Release;
    assert_eq!(t.encode_mouse(e).unwrap(), b"\x1b[<128;6;11m");
}

#[test]
fn back_button_rides_the_x10_default_framing() {
    // X10: Cb 128 + 32 = 160 still fits a single byte, so the +128 group encodes
    // fine in the default framing too; coords are +32.
    let mut t = Engine::new(80, 24);
    t.feed(b"\x1b[?1000h"); // default X10 encoding
    assert_eq!(
        t.encode_mouse(btn(MouseButton::Back, 5, 10)).unwrap(),
        vec![0x1b, b'[', b'M', 160, 38, 43]
    );
}

// #70 — ?9 X10 mouse: press-only, no release/motion/wheel, modifiers stripped
// (verified against xterm.js CoreMouseService X10 `restrict`).

#[test]
fn x10_mouse_reports_a_bare_press() {
    let mut t = Engine::new(80, 24);
    t.feed(b"\x1b[?9h"); // X10 tracking
    // Left press at (5,10) on the default X10 framing: Cb 0 + 32 = 32, coords +32.
    assert_eq!(
        t.encode_mouse(btn(MouseButton::Left, 5, 10)).unwrap(),
        vec![0x1b, b'[', b'M', 32, 38, 43]
    );
}

#[test]
fn x10_mouse_drops_release_motion_and_wheel() {
    let mut t = Engine::new(80, 24);
    t.feed(b"\x1b[?9h");
    let mut rel = btn(MouseButton::Left, 5, 10);
    rel.action = MouseAction::Release;
    assert!(t.encode_mouse(rel).is_none(), "X10 reports no release");
    let mut mv = btn(MouseButton::Left, 5, 10);
    mv.action = MouseAction::Motion;
    assert!(t.encode_mouse(mv).is_none(), "X10 reports no motion");
    assert!(
        t.encode_mouse(btn(MouseButton::WheelUp, 5, 10)).is_none(),
        "X10 reports no wheel",
    );
}

#[test]
fn x10_mouse_strips_modifiers() {
    let mut t = Engine::new(80, 24);
    t.feed(b"\x1b[?9h");
    let mut e = btn(MouseButton::Left, 5, 10);
    e.mods = Modifiers::CTRL;
    // Ctrl is stripped → identical bytes to a bare press (Cb 32, not 32 + 16).
    assert_eq!(
        t.encode_mouse(e).unwrap(),
        vec![0x1b, b'[', b'M', 32, 38, 43]
    );
}

#[test]
fn decrqm_reports_x10_mode() {
    let mut t = Engine::new(80, 24);
    t.feed(b"\x1b[?9$p"); // default off → reset
    assert_eq!(t.drain_replies(), b"\x1b[?9;2$y");
    t.feed(b"\x1b[?9h\x1b[?9$p"); // on → set
    assert_eq!(t.drain_replies(), b"\x1b[?9;1$y");
}

#[test]
fn urxvt_encoding_is_decimal_csi_m() {
    let mut t = Engine::new(80, 24);
    t.feed(b"\x1b[?1000h\x1b[?1015h"); // normal tracking + urxvt encoding
    // Left press at (5,10) 0-based → cb 0+32=32, 1-based decimal coords 6;11,
    // always terminated by 'M' (urxvt has no separate release 'm').
    assert_eq!(t.encode_mouse(press(5, 10)).unwrap(), b"\x1b[32;6;11M");
}

#[test]
fn utf8_encoding_multibyte_past_127() {
    // UTF-8 mode exists for terminals wider than the X10 byte ceiling.
    let mut t = Engine::new(300, 24);
    t.feed(b"\x1b[?1000h\x1b[?1005h"); // normal tracking + UTF-8 encoding
    // col 200 → cx value 200+1+32 = 233 → UTF-8 é (0xC3 0xA9); cb 32 → 0x20;
    // cy 10+1+32 = 43 → '+'. Like Default's CSI M but each value UTF-8 encoded.
    assert_eq!(
        t.encode_mouse(press(200, 10)).unwrap(),
        b"\x1b[M\x20\xc3\xa9\x2b"
    );
}

#[test]
fn sgr_pixels_uses_consumer_pixel_coordinates() {
    let mut t = Engine::new(80, 24);
    t.feed(b"\x1b[?1000h\x1b[?1016h"); // normal tracking + SGR-pixels
    // SGR framing (CSI < Cb ; X ; Y M), but X/Y are the consumer's 0-based
    // pixel coords (+1 to 1-based on the wire) — cell col/row are ignored.
    let mut e = press(5, 10);
    e.px = 411;
    e.py = 214;
    assert_eq!(t.encode_mouse(e).unwrap(), b"\x1b[<0;412;215M");
}

#[test]
fn sgr_pixels_release_uses_lowercase_m() {
    let mut t = Engine::new(80, 24);
    t.feed(b"\x1b[?1000h\x1b[?1016h");
    let mut e = press(5, 10);
    e.action = MouseAction::Release;
    e.px = 10;
    e.py = 20;
    // SGR keeps the button identity on release; terminator 'm'.
    assert_eq!(t.encode_mouse(e).unwrap(), b"\x1b[<0;11;21m");
}

#[test]
fn disabling_an_encoding_returns_to_default() {
    let mut t = Engine::new(80, 24);
    t.feed(b"\x1b[?1000h\x1b[?1015h"); // urxvt on
    t.feed(b"\x1b[?1015l"); // urxvt off → back to Default X10
    // Default X10: cb 0+32=' ', cx 6+32, cy 11+32.
    assert_eq!(
        t.encode_mouse(press(5, 10)).unwrap(),
        vec![0x1b, b'[', b'M', 32, 38, 43]
    );
}

// #129 — the motion gate per tracking mode. Each protocol's wanted-events set
// (the single source `encode_mouse` shares with the frame's routing mask) decides
// which motion reports; locked directly at the encode boundary so the shared-mask
// refactor cannot silently change it.

/// A motion event with an optional held button.
fn motion(button: Option<MouseButton>, col: usize, row: usize) -> MouseEvent {
    MouseEvent {
        button,
        action: MouseAction::Motion,
        col,
        row,
        px: 0,
        py: 0,
        mods: Modifiers::empty(),
    }
}

#[test]
fn normal_tracking_drops_all_motion() {
    let mut t = Engine::new(80, 24);
    t.feed(b"\x1b[?1000h"); // Normal: down/up/wheel only
    assert!(
        t.encode_mouse(motion(Some(MouseButton::Left), 5, 10))
            .is_none()
    );
    assert!(t.encode_mouse(motion(None, 5, 10)).is_none());
}

#[test]
fn button_event_reports_drag_but_not_bare_motion() {
    let mut t = Engine::new(80, 24);
    t.feed(b"\x1b[?1002h"); // ButtonEvent: + drag (motion with a button)
    assert!(
        t.encode_mouse(motion(Some(MouseButton::Left), 5, 10))
            .is_some()
    );
    assert!(t.encode_mouse(motion(None, 5, 10)).is_none());
}

#[test]
fn any_event_reports_bare_motion() {
    let mut t = Engine::new(80, 24);
    t.feed(b"\x1b[?1003h"); // AnyEvent: + bare motion
    assert!(t.encode_mouse(motion(None, 5, 10)).is_some());
}