///| 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
  }
}