///|
/// Public style values are semantic; no terminal escape sequences are emitted.
pub(all) enum Font {
  Roman
  Bold
  Italic
  Code
} derive(Eq, Debug)

///|
/// Positions count Unicode scalar values, with one-based lines and columns.
pub(all) struct Span {
  line : Int32
  column : Int32
  end_line : Int32
  end_column : Int32
} derive(Eq, Debug)

///|
pub(all) enum Severity {
  Warning
  Error
} derive(Eq, Debug)

///|
pub(all) struct Diagnostic {
  code : String
  message : String
  severity : Severity
  span : Span
} derive(Eq, Debug)

///|
pub(all) struct Inline {
  text : String
  font : Font
  target : String?
} derive(Eq, Debug)

///|
pub(all) enum BlockKind {
  Paragraph
  Heading(Int32)
  Tagged(Array[Inline])
  Hanging(Int32)
  Literal
  Synopsis
  Rule
} derive(Eq, Debug)

///|
pub(all) struct Block {
  kind : BlockKind
  inlines : Array[Inline]
  indent : Int32
  span : Span
} derive(Eq, Debug)

///|
pub(all) struct Metadata {
  title : String
  section : String
  date : String
  source : String
  manual : String
} derive(Eq, Debug)

///|
pub(all) struct Document {
  metadata : Metadata
  blocks : Array[Block]
  diagnostics : Array[Diagnostic]
} derive(Eq, Debug)

///|
pub fn Span::line_span(line : Int32, length : Int32) -> Span {
  { line, column: 1, end_line: line, end_column: length + 1, }
}

///|
pub fn Inline::text(text : String, font~ : Font = Roman) -> Inline {
  { text, font, target: None, }
}

///|
pub fn Metadata::empty() -> Metadata {
  { title: "", section: "", date: "", source: "", manual: "", }
}

///|
fn diagnostic(
  code : String,
  message : String,
  line : Int32,
  severity~ : Severity = Warning,
) -> Diagnostic {
  { code, message, severity, span: Span::line_span(line, 0), }
}

///|
pub fn Document::has_errors(self : Document) -> Bool {
  self.diagnostics.any(d => d.severity == Error)
}

///|
pub fn inline_text(inlines : Array[Inline]) -> String {
  let out = StringBuilder()
  for run in inlines {
    out.write_string(run.text)
  }
  out.to_string()
}

///|
pub extend Font with Eq::{equal, not_equal}

///|
pub extend Font with @debug.Debug::{to_repr}

///|
pub extend Span with Eq::{equal, not_equal}

///|
pub extend Span with @debug.Debug::{to_repr}

///|
pub extend Severity with Eq::{equal, not_equal}

///|
pub extend Severity with @debug.Debug::{to_repr}

///|
pub extend Diagnostic with Eq::{equal, not_equal}

///|
pub extend Diagnostic with @debug.Debug::{to_repr}

///|
pub extend Inline with Eq::{equal, not_equal}

///|
pub extend Inline with @debug.Debug::{to_repr}

///|
pub extend BlockKind with Eq::{equal, not_equal}

///|
pub extend BlockKind with @debug.Debug::{to_repr}

///|
pub extend Block with Eq::{equal, not_equal}

///|
pub extend Block with @debug.Debug::{to_repr}

///|
pub extend Metadata with Eq::{equal, not_equal}

///|
pub extend Metadata with @debug.Debug::{to_repr}

///|
pub extend Document with Eq::{equal, not_equal}

///|
pub extend Document with @debug.Debug::{to_repr}