Struct Diagnostic 

pub struct Diagnostic { /* private fields */ }

A build-time template-authoring diagnostic.

Construct with Diagnostic::error / Diagnostic::warning, attach context with the builder methods, then return it inside crate::ParserError::Template. The library never colors or prints it; the CLI reads the fields via the getters and renders them, while other hosts use the plain fmt::Display text.

Implementations

impl Diagnostic

pub fn error(title: impl Into<String>) -> Self

Start a fatal error diagnostic. Titles are short and lowercase by convention (e.g. invalid @click handler).

pub fn warning(title: impl Into<String>) -> Self

Start a non-fatal warning diagnostic.

Rendered with the same location/snippet/help: layout as an error, but the build continues (e.g. an unthemed literal-fallback CSS token).

pub fn code(self, code: &'static str) -> Self

Attach a stable, machine-readable error code (e.g. invalid-for-each).

The code is a constant identifier that does not change with the wording of the message, so tools and AI assistants can recognize the error class and apply a deterministic fix. Prefer the constants in codes.

pub fn component(self, component: impl Into<String>) -> Self

Name the owning component template (e.g. mail-inbox-page).

pub fn element(self, element: impl Into<String>) -> Self

Name the offending element tag (e.g. button), when known.

pub fn snippet(self, snippet: impl Into<String>) -> Self

Attach the offending source snippet (e.g. @click="bad()").

pub fn help(self, help: impl Into<String>) -> Self

Attach a help: hint describing the fix.

pub fn position(self, line: usize, column: usize) -> Self

Attach the 1-based (line, column) of the offending source location.

pub fn at_offset(self, source: &str, offset: usize) -> Self

Attach the source location computed from a byte offset into source.

Convenience over Diagnostic::position for callers that hold the source text and a byte offset (e.g. an element’s start). Computes the 1-based line and column in a single forward scan.

pub fn severity(&self) -> Severity

Severity of this diagnostic.

pub fn error_code(&self) -> Option<&'static str>

The stable, machine-readable error code, if set.

pub fn title(&self) -> &str

The short error title (e.g. invalid @click handler).

pub fn component_name(&self) -> Option<&str>

The owning component tag, if set.

pub fn element_name(&self) -> Option<&str>

The offending element tag, if set.

pub fn snippet_text(&self) -> Option<&str>

The offending source snippet, if set.

pub fn help_text(&self) -> Option<&str>

The help: hint, if set.

pub fn position_line_column(&self) -> Option<(usize, usize)>

The 1-based (line, column) of the offending source location, if known.

pub fn location(&self) -> Option<String>

Render the location line content (already including its leading marker), if any.

When a source position is known it is reported rustc-style as --> owner:line:column (the owner is the entry file or component tag), which is compact and recognizable. Without a position it falls back to a descriptive in component <c> · element <e> form. Returned so callers (e.g. the CLI) can render the location on its own styled line.

pub fn body(&self) -> String

Render the message body — everything after the severity label: title, location, offending snippet, and help: hint, each on its own line.

Used by callers that supply their own leading label (e.g. the dev server prints build error: {body}) so the severity word isn’t duplicated. fmt::Display prepends the severity to this body.

Trait Implementations

impl Clone for Diagnostic

fn clone(&self) -> Self

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 Display for Diagnostic

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

Render the plain, color-free report. Hosts that want color (the CLI) read the fields via the getters instead.

impl Eq for Diagnostic

impl From<Diagnostic> for ParserError

fn from(diagnostic: Diagnostic) -> Self

Converts to this type from the input type.

impl PartialEq for Diagnostic

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for Diagnostic