Struct ComponentStore 

pub struct ComponentStore { /* private fields */ }

Station-local sparse component blob store.

Implementations

impl ComponentStore

pub fn reserve_component( &mut self, component_id: ComponentId, additional_entities: usize, )

Reserves sparse blob entries for one component column.

pub fn reclaim_retained_capacity(&mut self)

Releases unused retained column and entity-map storage.

pub fn column_slots_capacity(&self) -> usize

Component column slots currently retained without another allocation.

pub fn component_capacity(&self, component_id: ComponentId) -> usize

Sparse entity entries retained for one component without another rehash.

pub fn set_blob( &mut self, descriptor: &ComponentDescriptor, entity: EntityHandle, version: u64, bytes: Vec<u8>, ) -> Result<(), ComponentStoreError>

Writes an opaque component blob.

pub fn set_blob_from_slice( &mut self, descriptor: &ComponentDescriptor, entity: EntityHandle, version: u64, bytes: &[u8], ) -> Result<(), ComponentStoreError>

Copies an opaque component value into retained blob storage.

Existing blob byte capacity is reused when sufficient. Validation runs before mutation, so failed writes leave the previous value unchanged.

pub fn set_typed<T, C: ComponentCodec<T>>( &mut self, descriptor: &ComponentDescriptor, entity: EntityHandle, version: u64, codec: &C, value: &T, ) -> Result<(), ComponentStoreError>

Encodes and writes a typed component value using codec.

pub fn set_typed_with_scratch<T, C: ComponentCodec<T>>( &mut self, descriptor: &ComponentDescriptor, entity: EntityHandle, version: u64, codec: &C, value: &T, scratch: &mut ComponentEncodeScratch, ) -> Result<(), ComponentStoreError>

Encodes a typed value through caller-owned scratch and copies it into retained blob storage.

pub fn get_blob( &self, component_id: ComponentId, entity: EntityHandle, ) -> Option<&ComponentBlob>

Gets an opaque component blob.

pub fn has_dirty_selected( &self, entity: EntityHandle, component_ids: &[ComponentId], ) -> bool

Returns whether any selected component on entity is dirty.

This is a low-level convenience for caller-owned replication eligibility rules; the store does not clear dirty state or track per-client delivery.

pub fn get_typed<T, C: ComponentCodec<T>>( &self, component_id: ComponentId, entity: EntityHandle, codec: &C, ) -> Result<T, ComponentStoreError>

Decodes a typed component value using codec.

pub fn get_blob_mut( &mut self, component_id: ComponentId, entity: EntityHandle, ) -> Option<&mut ComponentBlob>

Gets a mutable opaque component blob.

pub fn clear_dirty_for_entity(&mut self, entity: EntityHandle) -> usize

Clears dirty flags for all components on one entity.

pub fn remove_entity( &mut self, entity: EntityHandle, ) -> Vec<(ComponentId, ComponentBlob)>

Removes all component blobs for an entity and returns the removed values.

pub fn remove_entity_into( &mut self, entity: EntityHandle, removed: &mut Vec<(ComponentId, ComponentBlob)>, ) -> usize

Removes all component blobs into caller-owned reusable output storage.

pub fn clear_entity(&mut self, entity: EntityHandle) -> usize

Removes and drops all component blobs for an entity without output storage.

pub fn copy_for_migration( &mut self, registry: &ComponentRegistry, source: EntityHandle, target: EntityHandle, ) -> usize

Copies migratable component blobs from one entity handle to another.

pub fn blob_count(&self) -> usize

Returns number of component blobs stored in all columns.

pub fn column_count(&self) -> usize

Number of component columns currently registered in the store.

Trait Implementations

impl Clone for ComponentStore

fn clone(&self) -> ComponentStore

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for ComponentStore

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

Formats the value using the given formatter.

impl Default for ComponentStore

fn default() -> ComponentStore

Returns the “default value” for a type.