htui 0.2.0

use unicode_width::{UnicodeWidthChar, UnicodeWidthStr};

/// Display cell width of a single `char`.
///
/// Returns `0` for control characters, which do not consume a column. Width
/// values follow [Unicode Standard Annex #11] (East Asian Width), including
/// emoji ranges such as Emoticons, Misc Symbols and Pictographs, Transport,
/// and Dingbats.
///
/// Use [`grapheme_width`] for multi-codepoint constructs (ZWJ sequences such
/// as 👨‍👩‍👧, modifier sequences such as 👍🏽, presentation selectors such
/// as ❤️) — `char_width` only sees the leading codepoint and reports a
/// smaller width than the cluster actually occupies.
///
/// [Unicode Standard Annex #11]: https://www.unicode.org/reports/tr11/
pub fn char_width(c: char) -> usize {
    UnicodeWidthChar::width(c).unwrap_or(0)
}

/// Display cell width of an entire grapheme cluster.
///
/// Built on [`UnicodeWidthStr::width`], which honours the full set of
/// emoji-specific ligature rules (fully-qualified ZWJ sequences, modifier
/// sequences, emoji presentation sequences, script-specific ligatures) that
/// cannot be expressed at the `char` level. Falls back to summing per-char
/// widths for ordinary text.
pub fn grapheme_width(g: &str) -> usize {
    UnicodeWidthStr::width(g)
}