Struct SchemaBuilder 

pub struct SchemaBuilder { /* private fields */ }

Builder for constructing schema documents from Rust types.

The builder maintains:

• An arena of schema nodes
• A cache by TypeId to prevent duplicate definitions and handle recursion
• Type registrations for the $types namespace

Implementations

impl SchemaBuilder

pub fn new() -> Self

Create a new schema builder.

pub fn build<T: BuildSchema + 'static>(&mut self) -> SchemaNodeId

Build the schema for type T, with caching and recursion handling.

This is the primary method for building nested types. It:

1. Returns cached ID if already built (idempotent)
2. Reserves a node slot before building (handles recursion)
3. Calls T::build_schema() to get the content
4. For named types: registers in $types and returns a Reference node

pub fn create_node(&mut self, content: SchemaNodeContent) -> SchemaNodeId

Create a schema node with the given content.

Use this for creating anonymous/inline nodes that don’t need caching. For types that implement BuildSchema, prefer build::<T>().

pub fn create_node_with_metadata( &mut self, content: SchemaNodeContent, metadata: SchemaMetadata, ) -> SchemaNodeId

Create a schema node with content and metadata.

pub fn node_mut(&mut self, id: SchemaNodeId) -> &mut SchemaNode

Get mutable access to a node for adding ext_types or modifying metadata.

pub fn register_type(&mut self, name: &str, id: SchemaNodeId)

Register a named type in the $types namespace.

pub fn finish(self, root: SchemaNodeId) -> SchemaDocument

Consume the builder and produce the final schema document.

Trait Implementations

impl Default for SchemaBuilder

fn default() -> Self

Returns the “default value” for a type.