Struct DiagnosticsRulesConfig 

pub struct DiagnosticsRulesConfig {
    pub missing_footnote: RuleConfig,
    pub unused_footnote: RuleConfig,
    pub table_inconsistent_columns: RuleConfig,
    pub forbidden_label_prefix: RuleConfig,
    pub unknown_lex_canonical: RuleConfig,
    pub spellcheck: RuleConfig,
    pub schema: SchemaRulesConfig,
}

Per-rule severity for diagnostics.

One field per built-in diagnostic code. Each field’s doc comment is the description that surfaces in lexd config gen output, so authoring conventions for these doc comments matter: write them as user-facing prose, lead with what triggers the diagnostic, finish with the intrinsic default.

RuleConfig is a serde-untagged sum ("warn" or ["warn", { max = 80 }]), so every field carries #[clapfig(value)] — the leaf is a LeafType::Value escape hatch in the schema, and serde does the shape validation on deserialize. clapfig’s typo detection on the field names themselves still applies: a misspelled built-in like missing_footote is rejected as an unknown key. Extension-emitted codes (<namespace>.<code>) ride in via on_unknown_key and a side-channel populated by the loader — they are not fields on this struct.

Default returns every field at Severity::Warn regardless of each rule’s intrinsic default. Real production loads run through clapfig and honour the #[clapfig(default = "...")] annotations. Default is here so tests and ad-hoc embedders can construct an instance without going through the clapfig pipeline.

Fields

missing_footnote: RuleConfig

A footnote reference like [42] has no corresponding definition in the document. Intrinsic default: deny.

unused_footnote: RuleConfig

A footnote definition appears in the document but no reference points at it. Intrinsic default: warn.

table_inconsistent_columns: RuleConfig

A table row has a different number of columns than the table’s header row. Intrinsic default: warn.

forbidden_label_prefix: RuleConfig

A label uses the reserved doc.* prefix, which is no longer valid under the current label policy. Intrinsic default: deny.

unknown_lex_canonical: RuleConfig

A lex.* literal references a canonical that the toolchain does not recognise — typically a typo or a label written for a future core schema. Intrinsic default: deny.

spellcheck: RuleConfig

Spellcheck diagnostics. Intrinsic default: warn. Currently not consulted at emission time — spellcheck emits through a separate path in lex-analysis::spellcheck. The field is present so the value lives in the user-facing config schema; runtime wiring lands when spellcheck moves over to the AnalysisDiagnostic / DiagnosticKind pipeline.

schema: SchemaRulesConfig

Schema-validation diagnostics for extension labels.

Implementations

impl DiagnosticsRulesConfig

pub fn lookup_by_code(&self, code: &str) -> Option<&RuleConfig>

Look up a rule by its on-the-wire code (e.g. "missing-footnote" or "schema.unknown-label").

Only consults named built-in fields. Extension-emitted codes (<namespace>.<code>) live in a separate side-channel map populated by the loader’s on_unknown_key callback and stored on LoadedLexConfig::extension_diagnostic_rules; use LoadedLexConfig::lookup_diagnostic_rule to consult both surfaces with a single call.

Trait Implementations

impl Clone for DiagnosticsRulesConfig

fn clone(&self) -> DiagnosticsRulesConfig

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for DiagnosticsRulesConfig

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

Formats the value using the given formatter.

impl Default for DiagnosticsRulesConfig

fn default() -> DiagnosticsRulesConfig

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for DiagnosticsRulesConfig

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Schema for DiagnosticsRulesConfig

const STATIC: &'static SchemaStatic

The macro-emitted const schema tree. Const so it composes inside nested static SchemaStatic = ... initializers.

fn schema() -> &'static Schema

Cached runtime view. The macro emits this method explicitly with a per-impl OnceLock; the helper cached_runtime_schema keeps the generated body small.

fn schema_arc() -> Arc<Schema>

Arc-flavored access to the same cached runtime view. Used by the macro-driven builder (crate::SchemaConfigBuilder) to avoid cloning the schema tree per builder construction — the runtime spec stores an Arc<Schema> and the cache hands out cheap reference-counted handles to it. Cost: one Arc::clone per call (atomic increment, no allocation).

fn schema_static() -> &'static SchemaStatic

Convenience accessor; equivalent to Self::STATIC.

fn field_paths() -> Vec<String>

Flat list of every dotted path the schema knows about: leaf addressable keys plus every nested-section and array-of-objects node. Lets consumer code (extension registries, doc generators, --list-keys flags) replace hand-maintained “known paths” constants — the macro recomputes the list every time a field is added or removed.

impl Serialize for DiagnosticsRulesConfig

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

where __S: Serializer,

Serialize this value into the given Serde serializer.