Struct Resolver 

pub struct Resolver<'a> {
    pub components: BTreeMap<String, Value>,
    pub gaps: Vec<Gap>,
    pub aux_resolved: BTreeSet<String>,
    /* private fields */
}

Walks rustdoc JSON, emitting JSON Schema and collecting Gaps.

Resolution may span several documents (see Docs), but components, the component-name registry and the cycle-breaking stack are shared across all of them: one type gets one component wherever it was defined.

Fields

components: BTreeMap<String, Value>

Named schemas, emitted as components/schemas in OpenAPI.

gaps: Vec<Gap>

aux_resolved: BTreeSet<String>

Canonical paths walked out of an auxiliary document. Resolved, so deliberately not gaps — reported only to say where they came from.

Implementations

impl<'a> Resolver<'a>

pub fn new( docs: impl Into<Docs<'a>>, table: &'a TypeTable, ) -> Result<Self, String>

Build a resolver over a parsed rustdoc JSON document, or over a primary document plus its workspace-local companions (Docs).

pub fn find_type_id(&self, name: &str) -> Option<Value>

Find a struct or enum by its plain name, for attribute overrides that name a type rather than pointing at a signature.

pub fn find_by_path(&self, canonical: &str) -> Option<&'a Value>

Find an item by its fully-qualified path, e.g. app::routes::create.

#[route] records handler ids as module_path!()::fn_name, which is exactly the path rustdoc reports, so route lookup is a direct match.

pub fn resolve_by_name(&mut self, name: &str, at: &str) -> Option<Value>

Resolve a struct or enum named in an attribute, searching this crate first and then the workspace-local documents.

pub fn is_option(ty: &Value) -> bool

True when a type is Option<..>, which makes a field optional on the wire independently of the schema its inner type produces.

pub fn resolve(&mut self, ty: &Value, subst: &Subst, at: &str) -> Value

Resolve one rustdoc type node into a JSON Schema.

at is a human-readable location (Item.when) used for gap reports.