Struct Schema 

pub struct Schema {
    pub schema_version: u32,
    pub label: String,
    pub description: Option<String>,
    pub params: BTreeMap<String, ParamSpec>,
    pub attaches_to: Vec<String>,
    pub body: BodyShape,
    pub verbatim_label: bool,
    pub capabilities: Capabilities,
    pub hooks: HookSet,
    pub handler: Option<HandlerSpec>,
    pub diagnostics: Vec<DiagnosticDecl>,
}

One label’s schema. Mirrors the YAML format documented in the Extending Lex proposal §13.2.

Schemas are strict on deserialise: unknown fields are rejected. Forward compatibility lives at the wire_version axis, not at the schema-format level — a schema with a field this version doesn’t know about is malformed by definition. The schema loader (lex-extension-host) surfaces this as a precise SchemaError.

Fields

schema_version: u32

Schema-format version. Currently 1.

label: String

Fully-qualified label, e.g. "acme.commenting".

description: Option<String>

params: BTreeMap<String, ParamSpec>

Declared parameters, keyed by name.

attaches_to: Vec<String>

Permitted host node kinds.

body: BodyShape

Body shape when the label is used as an annotation.

verbatim_label: bool

Whether the label is also legal as a verbatim block closing.

capabilities: Capabilities

Declared OS-level capabilities the handler needs. Honoured once sandboxing is in place; see proposal §8.

hooks: HookSet

Hooks the label participates in.

handler: Option<HandlerSpec>

Optional handler delivery info. Schema-only labels (validation + editor UX from the schema alone) omit this.

diagnostics: Vec<DiagnosticDecl>

Diagnostic codes this label’s handler can emit. Declaring them lets the host schema-validate [diagnostics.rules] entries against the resolved registry — a <namespace>.<code> rule whose <code> matches nothing declared here is a dead letter the host can flag — and lets config/editor tooling surface the available codes with their descriptions and default severity.

Trait Implementations

impl Clone for Schema

fn clone(&self) -> Schema

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Schema

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Schema

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for Schema

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

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 Schema