rdom-tui 0.5.0

//! `<button>` keyboard activation — Enter and Space on a
//! focused button synthesize a `click` event.
//!
//! ## Contract (from MDN)
//!
//! - Enter and Space both activate a focused `<button>`.
//! - The synthesized click is a normal DOM click event — bubbles,
//!   cancelable, fires on the button. Handlers that listen for
//!   `click` receive it; an `event.preventDefault()` on the click
//!   suppresses any downstream effects (e.g. the anchor-dispatch
//!   listener from C.2 respects it the same way).
//! - `disabled` buttons don't fire (focus-nav already skips
//!   disabled, so a disabled button can't be the focus target
//!   of a keydown — covered by Phase C.1).
//! - The synthetic click carries `is_synthetic = true` so
//!   runtime default-actions (C.2 `<a href>`, future `<form>`
//!   submission) can distinguish keyboard-origin clicks from
//!   mouse clicks if they ever need to.
//!
//! ## Why a root listener
//!
//! Same reason as `a_href`: browsers don't install per-element
//! listeners, they have built-in default actions. One
//! registration at the document root handles every button the
//! app will ever contain.
//!
//! ## `type` attribute
//!
//! Ship type-agnostic activation for C.3. `type="submit"` /
//! `type="reset"` → form submission / reset behavior arrives in
//! C.4c when `<form>` lands. For now all three types synthesize
//! a plain click.

use crossterm::event::{KeyModifiers, MouseButton, MouseEvent, MouseEventKind};

use rdom_core::ListenerOptions;

use crate::{TuiDom, TuiEvent};

/// Install the button keyboard-activation default action. Called
/// once from `App::build`.
///
/// C.4c expansion: the same Enter/Space activation also fires on
/// `<input type="submit">`, `<input type="reset">`, and
/// `<input type="button">` — these behave as buttons for keyboard
/// activation, then the form builtin (C.4c) handles the resulting
/// click as a submit / reset trigger.
pub fn install(dom: &mut TuiDom) {
    let root = dom.root();
    dom.add_event_listener(root, "keydown", ListenerOptions::default(), move |ctx| {
        if ctx.event.default_prevented() {
            return;
        }
        // Focused element must be a `<button>` or one of the
        // button-like `<input>` variants.
        let Some(focused) = ctx.dom.focused() else {
            return;
        };
        if !is_button_like(ctx.dom, focused) {
            return;
        }
        // Read the typed keyboard payload off the dispatching event.
        let Some(key) = ctx.event.detail.as_keyboard() else {
            return;
        };
        // Modifier combos (Ctrl-Enter, Alt-Space, …) are NOT
        // activation — they belong to clipboard / selection /
        // editing paths. Bare Enter or Space only.
        if key.modifiers.ctrl || key.modifiers.alt || key.modifiers.meta {
            return;
        }
        let triggers = matches!(key.key.as_str(), "Enter" | " ");
        if !triggers {
            return;
        }
        // Synthesize the click.
        let fake_mouse = MouseEvent {
            kind: MouseEventKind::Up(MouseButton::Left),
            column: 0,
            row: 0,
            modifiers: KeyModifiers::empty(),
        };
        let mut click = TuiEvent::click(fake_mouse);
        click.event = click.event.clone().with_synthetic(true);
        crate::tui_event::dispatch_to_live(ctx.dom, focused, &mut click);
        // Claim the activation key so the app's default-action chain
        // (focused-scroll-container keymap, Tab focus nav) doesn't ALSO act on
        // it — e.g. Space would otherwise both activate the button and page
        // the scroll container it sits in.
        ctx.event.prevent_default();
    })
    .expect("root button keydown listener install");
}

/// True for `<button>` and for the button-like `<input>` types
/// (`submit`, `image`, `reset`, `button`). These input types render
/// as buttons (an image button, having no image in rdom, as one
/// labelled with its `alt`) and share its keyboard activation.
pub(super) fn is_button_like(dom: &TuiDom, id: rdom_core::NodeId) -> bool {
    use rdom_core::InputTypeState as T;
    dom.node(id).tag_name() == Some("button")
        || matches!(
            dom.input_type_state(id),
            Some(T::Submit | T::Image | T::Reset | T::Button)
        )
}

#[cfg(test)]
mod tests;