justerm-core 0.22.0

A pure terminal engine: VT byte stream to grid + scrollback + damage. No I/O, no rendering, theme-agnostic.
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

//! Viewport logical lines (#113, ADR-0017): soft-wrap-joined text plus a
//! per-char map back to viewport cells. This is the buffer-wide *mechanism* a
//! frame-mode consumer needs for URL detection — the regex and `new URL()`
//! validation stay consumer-side (policy). It also serves the a11y screen-reader
//! mirror (#119). The cell-aware assembly lives in `term/logical.rs` — the `Term` half
//! of this model, moved out of `term.rs` in #601; this module is just the returned shape.

/// One soft-wrap-joined logical line touching the viewport.
///
/// **No `#[non_exhaustive]` ([#844](https://github.com/kihyun1998/justerm/issues/844)): nothing outside this crate has a reason to build one.** No
/// public function accepts it — the engine hands it out — and there are zero out-of-crate literal
/// sites, so the attribute would bind nothing it does not already bind.
#[derive(Clone, PartialEq, Eq, Debug)]
pub struct LogicalLine {
    /// The line text: wrap-joined across soft-wrapped rows, wide-char spacers
    /// skipped, trailing blanks trimmed. This is **not** the equivalence to xterm.js's
    /// `BufferLine.translateToString(true)` an earlier version of this comment claimed. The
    /// spacer skip matches; the wrap join does not (that method spans one `BufferLine` —
    /// xterm pairs it with `Buffer.getWrappedRangeForLine`); and the trim still differs,
    /// but on a **narrower** case than this comment used to name. A `str::trim_end()` would
    /// apply the Unicode `White_Space` property and drop a printed
    /// U+00A0 / U+3000 / U+2003 as well; this removes only `' '` — the codepoint a blank
    /// cell packs, and therefore the only one that can be padding. What remains is a
    /// printed trailing **ASCII space**, which xterm keeps (it bounds by written extent)
    /// and this cannot, because `Cell` has no bit distinguishing a written `' '` from a
    /// blank. Pinned in [`docs/agents/reference-facts.md`](https://github.com/kihyun1998/justerm/blob/master/docs/agents/reference-facts.md) § "Trimming a line's end" and
    /// [`docs/map/invariant/only-u0020-can-be-padding.md`](https://github.com/kihyun1998/justerm/blob/master/docs/map/invariant/only-u0020-can-be-padding.md).
    pub text: String,
    /// Per `text` char, the viewport cell `(row, col)` it came from. A `row`
    /// outside `0..rows` is off-screen wrapped context (a line that wraps in from
    /// above the top / out past the bottom) — present so a URL spanning the edge
    /// still matches; the consumer highlights only the in-range cells.
    pub cells: Vec<(i32, usize)>,
}