///| Safe link policy for generated documents: explicit web/mail schemes and anchors.
///|
/// This is an emission policy, not a network reachability or URL ownership check.
pub fn safe_target(target : String) -> Bool {
if target == "" {
return false
}
for c in target.iter() {
if c.is_whitespace() ||
c.is_control() ||
c == '<' ||
c == '>' ||
c == '"' ||
c == '\\' {
return false
}
}
let lower = target.to_lower()
if lower.has_prefix("https://") || lower.has_prefix("http://") {
let offset = if lower.has_prefix("https://") { 8 } else { 7 }
let chars = target.to_array()
return chars.length() > offset &&
chars[offset] != '/' &&
chars[offset] != '?' &&
chars[offset] != '#'
}
if lower.has_prefix("mailto:") {
return target.length() > 7
}
target.has_prefix("#") && target.length() > 1
}
///|
fn Parser::link_request(
self : Parser,
name : String,
args : Array[String],
line : Int32,
) -> Bool {
match name {
"UR" | "MT" => {
if self.active_link is Some(_) {
self.warn("nested-link", "Previous link closed by a new link", line)
}
if args.is_empty() {
self.warn("missing-link", "Link macro requires a target", line)
self.active_link = None
} else {
let target = if name == "MT" {
"mailto:" + self.plain_arg(args, 0, line)
} else {
self.plain_arg(args, 0, line)
}
if !safe_target(target) {
self.diagnostics.push(
diagnostic(
"unsafe-link",
"Target will be emitted as text only",
line,
severity=Error,
),
)
}
self.active_link = Some(target)
self.link_kind = name
self.link_has_label = false
}
true
}
"UE" | "ME" => {
match self.active_link {
None =>
self.warn("unmatched-link", "Link end has no matching start", line)
Some(target) => {
if !self.link_has_label {
let label = if self.link_kind == "MT" {
chars_string(target.to_array(), 7, target.to_array().length())
} else {
target
}
self.append(label, line)
}
if (name == "ME" && self.link_kind != "MT") ||
(name == "UE" && self.link_kind != "UR") {
self.warn(
"mismatched-link", "Link end differs from its opening macro", line,
)
}
self.active_link = None
self.link_kind = ""
self.append(joined_arguments(args), line, join=false)
}
}
true
}
_ => false
}
}