textlane-html 0.3.0

Textlane's HTML plugins: parsing, transforms, sanitizing and serializing
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
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113

use textlane_core::hast::{Element, Node, PropertyItem, PropertyValue};

use crate::helpers::value::{find_value, is_truthy};

/// Whether a hast node is phrasing content, as hast-util-phrasing decides.
pub(crate) fn is_phrasing(node: &Node<'_>) -> bool {
    match node {
        Node::Text(_) => true,
        Node::Element(element) => {
            is_basic_phrasing(element.tag_name)
                || is_embedded(element)
                || is_body_ok_link(element)
                || (element.tag_name == "meta" && has_property(element, "itemProp"))
        }
        _ => false,
    }
}

/// Whether an element embeds other content, as hast-util-embedded decides.
pub(crate) fn is_embedded(element: &Element<'_>) -> bool {
    matches!(
        element.tag_name,
        "audio"
            | "canvas"
            | "embed"
            | "iframe"
            | "img"
            | "math"
            | "object"
            | "picture"
            | "svg"
            | "video"
    )
}

fn is_basic_phrasing(tag_name: &str) -> bool {
    matches!(
        tag_name,
        "a" | "abbr"
            | "area"
            | "b"
            | "bdi"
            | "bdo"
            | "br"
            | "button"
            | "cite"
            | "code"
            | "data"
            | "datalist"
            | "del"
            | "dfn"
            | "em"
            | "i"
            | "input"
            | "ins"
            | "kbd"
            | "keygen"
            | "label"
            | "map"
            | "mark"
            | "meter"
            | "noscript"
            | "output"
            | "progress"
            | "q"
            | "ruby"
            | "s"
            | "samp"
            | "script"
            | "select"
            | "small"
            | "span"
            | "strong"
            | "sub"
            | "sup"
            | "template"
            | "textarea"
            | "time"
            | "u"
            | "var"
            | "wbr"
    )
}

// hast-util-is-body-ok-link: a `link` with `itemProp`, or whose `rel` only names
// `pingback`, `prefetch` or `stylesheet`
fn is_body_ok_link(element: &Element<'_>) -> bool {
    if element.tag_name != "link" {
        return false;
    }
    if is_truthy(find_value(element, "itemProp")) {
        return true;
    }
    match find_value(element, "rel") {
        Some(PropertyValue::List(items)) if !items.is_empty() => {
            items.iter().all(|item| match item {
                PropertyItem::String(value) => {
                    matches!(*value, "pingback" | "prefetch" | "stylesheet")
                }
                PropertyItem::Number(_) => false,
            })
        }
        _ => false,
    }
}

// hast-util-has-property: set to anything but `null`, `undefined` or `false`
fn has_property(element: &Element<'_>, name: &str) -> bool {
    !matches!(
        find_value(element, name),
        None | Some(PropertyValue::Null) | Some(PropertyValue::Boolean(false))
    )
}