Enum ErrorCode 

#[non_exhaustive]
pub enum ErrorCode {
    EmptyComponents,
    MissingId,
    MissingComponentType,
    DuplicateId,
    NoRoot,
    UnknownComponent,
    MissingRequiredProp,
    MissingField,
    InvalidValue,
    TypeMismatch,
    UnresolvedChild,
    ChildCycle,
    UnresolvedBinding,
    MaxDepthExceeded,
}

The complete set of semantic failures this validator reports.

Deliberately closed: these codes are the contract with callers that route on them (a recovery loop, a renderer’s error channel), so adding one is a breaking change. Composition-constraint failures have their own codes and live in crate::catalog::CompositionCode.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

EmptyComponents

The payload declares a surface but carries no components.

MissingId

A component has no usable id.

MissingComponentType

A component has no usable component type name.

DuplicateId

Two components share an id.

NoRoot

No component has the root id, so the renderer has nothing to draw from.

UnknownComponent

A component’s type is not defined by the surface’s catalog.

MissingRequiredProp

A property the catalog marks required is missing.

MissingField

A field the protocol requires on a message envelope is missing.

Distinct from ErrorCode::MissingRequiredProp, which is about a component property a catalog declares: this one is fixed by the wire format and holds whatever catalog is in play.

InvalidValue

A value has the right shape but is not one the protocol permits, such as a version naming a protocol revision this crate does not speak.

TypeMismatch

A value is of the wrong JSON type — "3" where a number is required, or a number where the catalog declares a string.

UnresolvedChild

A child reference names a component id that does not exist.

ChildCycle

Following child references leads back to where it started.

UnresolvedBinding

A data binding cannot resolve against the surface’s data model.

MaxDepthExceeded

Nesting runs deeper than the configured maximum.

Distinct from ErrorCode::ChildCycle: a deep tree is finite and acyclic, it is just deeper than anything a renderer will draw, and deep enough to threaten a recursive consumer. Covers three kinds of nesting — the component graph, the raw JSON, and chained function calls — because all three are model-generated and all three are unbounded without a cap.

Implementations

impl ErrorCode

pub fn as_str(self) -> &'static str

The wire string for this code.

Trait Implementations

impl Clone for ErrorCode

fn clone(&self) -> ErrorCode

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for ErrorCode

impl Debug for ErrorCode

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for ErrorCode

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for ErrorCode

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

Formats the value using the given formatter.

impl Eq for ErrorCode

impl Ord for ErrorCode

fn cmp(&self, other: &ErrorCode) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

where Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized,

Restrict a value to a certain interval.

impl PartialEq for ErrorCode

fn eq(&self, other: &ErrorCode) -> 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 PartialOrd for ErrorCode

fn partial_cmp(&self, other: &ErrorCode) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

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

Tests less than (for self and other) and is used by the < operator.

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

Tests less than or equal to (for self and other) and is used by the <= operator.

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

Tests greater than (for self and other) and is used by the > operator.

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

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl Serialize for ErrorCode

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for ErrorCode