Struct TypeRegistry 

pub struct TypeRegistry { /* private fields */ }

A registry for collecting and managing TypeScript type definitions.

The TypeRegistry collects named types, resolves their dependency order, and renders them to a TypeScript file. This enables:

• Deduplication: Each named type is emitted once
• Ordering: Types are emitted in dependency order
• Output: Generate valid .ts or .d.ts files

Example

use ferrotype::{TypeRegistry, TypeScript};

let mut registry = TypeRegistry::new();
registry.register::<User>();
registry.register::<Post>();

let output = registry.render();
std::fs::write("types.ts", output)?;

Implementations

impl TypeRegistry

pub fn new() -> Self

Creates a new empty registry.

pub fn from_distributed() -> Self

Creates a registry populated with all auto-registered types.

This collects all types that were registered via the #[derive(TypeScript)] macro using the distributed slice mechanism.

Example

use ferrotype::{TypeRegistry, TypeScript};

#[derive(TypeScript)]
struct User { name: String, age: u32 }

#[derive(TypeScript)]
struct Post { title: String, author: User }

// Collect all types automatically - no manual registration needed!
let registry = TypeRegistry::from_distributed();
println!("{}", registry.render());

pub fn collect_all(&mut self)

Collects all auto-registered types into this registry.

This is useful when you want to add auto-registered types to an existing registry that may already have some manually registered types.

Example

let mut registry = TypeRegistry::new();
// Add some manual types first
registry.register::<SomeManualType>();
// Then collect all auto-registered types
registry.collect_all();

pub fn register<T: TypeScript>(&mut self)

Registers a type that implements TypeScript.

This extracts all named types from the type definition and adds them to the registry. Named types are deduplicated by name.

pub fn add_typedef(&mut self, typedef: TypeDef)

Adds a TypeDef to the registry, extracting all named types.

pub fn len(&self) -> usize

Returns the number of registered types.

pub fn is_empty(&self) -> bool

Returns true if no types are registered.

pub fn type_names(&self) -> impl Iterator<Item = &str>

Returns the names of all registered types.

pub fn get(&self, name: &str) -> Option<&TypeDef>

Gets a type definition by name.

pub fn sorted_types(&self) -> Vec<&str>

Returns types in dependency order (types with no dependencies first).

Uses Kahn’s algorithm for topological sort.

pub fn render(&self) -> String

Renders all registered types to TypeScript declarations.

Types are emitted in dependency order, with proper formatting.

pub fn render_exported(&self) -> String

Renders all registered types with export keywords.

For namespaced types, exports the namespace declaration.

pub fn clear(&mut self)

Clears all registered types.

Trait Implementations

impl Debug for TypeRegistry

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

Formats the value using the given formatter.

impl Default for TypeRegistry

fn default() -> TypeRegistry

Returns the “default value” for a type.