Struct Diagnostic 

pub struct Diagnostic {
    pub code: String,
    pub severity: Severity,
    pub message: String,
    pub span: Option<Span>,
    pub subject_id: Option<String>,
}

A single structured diagnostic produced during validation or resolution.

Diagnostics carry a stable code that agents and tooling can key on, a human-readable message, an optional source span, and an optional subject_id naming the token (or future: node/style) the diagnostic is about.

Fields

code: String

Stable dot-separated code, e.g. "token.cyclic_reference".

severity: Severity

Severity classification.

message: String

Human-readable description.

span: Option<Span>

Source location, when available.

subject_id: Option<String>

The token ID (or future: node/style ID) the diagnostic concerns.

Implementations

impl Diagnostic

pub fn new( code: impl Into<String>, severity: Severity, message: impl Into<String>, span: Option<Span>, subject_id: Option<String>, ) -> Self

Construct a new diagnostic with all fields explicit.

pub fn error( code: impl Into<String>, message: impl Into<String>, span: Option<Span>, subject_id: Option<String>, ) -> Self

Shorthand for an Severity::Error-level diagnostic.

pub fn warning( code: impl Into<String>, message: impl Into<String>, span: Option<Span>, subject_id: Option<String>, ) -> Self

Shorthand for a Severity::Warning-level diagnostic.

pub fn advisory( code: impl Into<String>, message: impl Into<String>, span: Option<Span>, subject_id: Option<String>, ) -> Self

Shorthand for an Severity::Advisory-level diagnostic.

Trait Implementations

impl Clone for Diagnostic

fn clone(&self) -> Diagnostic

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Diagnostic

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl PartialEq for Diagnostic

fn eq(&self, other: &Diagnostic) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl StructuralPartialEq for Diagnostic