Struct Registry 

pub struct Registry<T> { /* private fields */ }

A strict, capacity-limited registry that separates Cold Path (registration) from Hot Path (access) to ensure consistent performance.

Implementations

impl<T> Registry<T>

pub fn new(capacity: usize) -> Result<Self, RegistryError>

Creates a new registry with a fixed capacity. Pre-allocates all necessary memory to avoid runtime allocations.

pub fn register( &mut self, name: impl Into<String>, item: T, ) -> Result<HandlerId<T>, RegistryError>

[Cold Path] Registers an item with a string ID. Fails if capacity is exceeded or name already exists.

pub fn get(&self, id: HandlerId<T>) -> Option<&T>

[Hot Path] Access item by ID (No allocation, O(1))

pub fn get_mut(&mut self, id: HandlerId<T>) -> Option<&mut T>

[Hot Path] Mutable access item by ID (No allocation, O(1))

pub fn lookup(&self, name: &str) -> Option<HandlerId<T>>

[Cold Path] Look up a handler ID by name

pub fn remove(&mut self, id: HandlerId<T>) -> Option<T>

[Cold Path] Remove an item by ID. Updates generation to invalidate old handles and cleans up name map.

pub fn capacity(&self) -> usize

Returns the fixed capacity of the registry.

pub fn count(&self) -> usize

Returns the current number of items.

pub fn keys(&self) -> impl Iterator<Item = &String>

Returns an iterator over all registered names.

pub fn iter(&self) -> impl Iterator<Item = (&String, &T)>

Returns an iterator over all registered items with their names.