rdom-tui 0.3.3

Terminal rendering layer for rdom-core — flexbox layout, TUI styles, key/mouse events. Use rdom-core directly for headless DOM manipulation.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98

//! `user-select` policy — `UserSelect::{None, All, Contain}` apply
//! logic shared by mouse drag, keyboard extension, and clipboard
//! serialization.
//!
//! The CSS property + cascade rung lives in `rdom-style`; this
//! module owns the runtime *behavior* the property controls.
//!
//! ## Behaviors
//!
//! - **`None`** — the subtree is unselectable. Drag, keyboard
//!   extension, and clipboard serialize all skip it.
//! - **`All`** — the host is selected atomically. A click anywhere
//!   inside expands the selection to span the host's full text;
//!   subsequent drag-extend and keyboard-extend are suppressed
//!   while the focus remains inside the host.
//! - **`Contain`** — selections started inside the host cannot
//!   escape. Drag-extend whose hit position falls outside the host
//!   clamps to the nearest in-host position.
//!
//! `Auto` / `Text` are no-ops at the policy layer — they reflect
//! the default "selectable" state the drag pipeline assumes.

use crossterm::event::MouseEvent;

use rdom_core::{NodeId, Position, Selection};

use crate::TuiDom;
use crate::layout::UserSelect;
use crate::node::{TuiNodeExt, first_text_descendant, last_text_descendant, text_len};

/// First ancestor of `id` (inclusive) whose computed `user-select`
/// matches `value`. Returns the host element so callers can scope
/// per-value behavior to its subtree.
pub(crate) fn ancestor_with(dom: &TuiDom, id: NodeId, value: UserSelect) -> Option<NodeId> {
    let mut cur = Some(id);
    while let Some(n) = cur {
        if let Some(c) = dom.node(n).computed()
            && c.user_select == value
        {
            return Some(n);
        }
        cur = dom.node(n).parent_node().map(|p| p.id());
    }
    None
}

/// True iff `id` or any ancestor has `user-select: none` in its
/// computed style. Skip-list for the selection algorithm — used
/// by mouse hit-test, keyboard extension, and clipboard serialize.
pub(crate) fn has_none_ancestor(dom: &TuiDom, id: NodeId) -> bool {
    ancestor_with(dom, id, UserSelect::None).is_some()
}

/// Build a Selection spanning every character of `host`'s text
/// subtree. Anchor = first text node start, focus = last text node
/// end. Returns `None` when no text exists.
pub(crate) fn span_all_text(dom: &TuiDom, host: NodeId) -> Option<Selection> {
    let first = first_text_descendant(dom, host)?;
    let last = last_text_descendant(dom, host).unwrap_or(first);
    let end = text_len(dom, last);
    Some(Selection::new(
        Position::new(first, 0),
        Position::new(last, end),
    ))
}

/// Clamp focus to the nearest in-host position for
/// `user-select: contain`. The cursor's row + column decides which
/// boundary to land on:
///
/// - above host → first text descendant, offset 0;
/// - below host → last text descendant, offset = len;
/// - same vertical extent, past the right edge → last text end;
/// - same vertical extent, before the left edge → first text start.
pub(crate) fn clamp_to_contain_host(
    dom: &TuiDom,
    host: NodeId,
    mouse: MouseEvent,
) -> Option<Position> {
    let rect = dom.node(host).layout_rect()?;
    let below = (mouse.row as i32) >= rect.y + rect.height as i32;
    let above = (mouse.row as i32) < rect.y;
    let want_end = if below {
        true
    } else if above {
        false
    } else {
        (mouse.column as i32) >= rect.x + rect.width as i32
    };

    if want_end {
        let node = last_text_descendant(dom, host)?;
        Some(Position::new(node, text_len(dom, node)))
    } else {
        let node = first_text_descendant(dom, host)?;
        Some(Position::new(node, 0))
    }
}