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