Struct HandleRegistry 

pub struct HandleRegistry<K: HandleKind> { /* private fields */ }

Per-kind token registry: opaque u64 id allocation plus live-resource storage. A Resource, inserted by register_handle_kind.

BTreeMap (not HashMap) for deterministic iteration — GC and snapshot walk live in id order (CLAUDE.md determinism rule).

Implementations

impl<K: HandleKind> HandleRegistry<K>

pub fn new(implementor: K) -> Self

pub fn mint(&mut self, resource: K::Resource) -> u64

Mint a fresh opaque token id for resource, storing it live.

pub fn mint_value( &mut self, program: &Program, resource: K::Resource, ) -> Option<Value>

Mint a token and build the ink-facing Value::Handle for it, resolving this kind’s name id against program’s name table. None if this compile never interned HandleKind::KIND (no Handle<K>-typed signature/annotation anywhere in the source graph — see Program::name_id).

pub fn get(&self, id: u64) -> Option<&K::Resource>

pub fn contains(&self, id: u64) -> bool

pub fn remove(&mut self, id: u64) -> Option<K::Resource>

pub fn len(&self) -> usize

pub fn is_empty(&self) -> bool

pub fn get_or_dead<M: Send + Sync + 'static>( &self, id: u64, commands: &mut Commands<'_, '_>, flow: Entity, ) -> Option<&K::Resource>

Look up a token, firing BrinkDeadHandleDeref at flow when it’s dead. Opt-in dead-deref telemetry (spec §4): a binding that just wants a silent None should use get instead.

Trait Implementations

impl<K: HandleKind> Component for HandleRegistry<K>

where Self: Send + Sync + 'static,

const STORAGE_TYPE: StorageType = bevy_ecs::component::StorageType::SparseSet

A constant indicating the storage type used for this component.

type Mutability = Mutable

A marker type to assist Bevy with determining if this component is mutable, or immutable. Mutable components will have Component<Mutability = Mutable>, while immutable components will instead have Component<Mutability = Immutable>.

fn register_required_components( _requiree: ComponentId, required_components: &mut RequiredComponentsRegistrator<'_, '_>, )

Registers required components.

fn clone_behavior() -> ComponentCloneBehavior

Called when registering this component, allowing to override clone function (or disable cloning altogether) for this component.

fn relationship_accessor() -> Option<ComponentRelationshipAccessor<Self>>

Returns ComponentRelationshipAccessor required for working with relationships in dynamic contexts.

fn on_add() -> Option<for<'w> fn(DeferredWorld<'w>, HookContext)>

Gets the on_add ComponentHook for this Component if one is defined.

fn on_insert() -> Option<for<'w> fn(DeferredWorld<'w>, HookContext)>

Gets the on_insert ComponentHook for this Component if one is defined.

fn on_discard() -> Option<for<'w> fn(DeferredWorld<'w>, HookContext)>

Gets the on_discard ComponentHook for this Component if one is defined.

fn on_remove() -> Option<for<'w> fn(DeferredWorld<'w>, HookContext)>

Gets the on_remove ComponentHook for this Component if one is defined.

fn on_despawn() -> Option<for<'w> fn(DeferredWorld<'w>, HookContext)>

Gets the on_despawn ComponentHook for this Component if one is defined.

fn map_entities<E>(_this: &mut Self, _mapper: &mut E)

where E: EntityMapper,

Maps the entities on this component using the given EntityMapper. This is used to remap entities in contexts like scenes and entity cloning. When deriving Component, this is populated by annotating fields containing entities with #[entities]

impl<K: HandleKind> Resource for HandleRegistry<K>

where Self: Send + Sync + 'static,