Struct TrackedWorld 

pub struct TrackedWorld { /* private fields */ }

A wrapper around SimpleWorld that automatically records component changes.

Similar to HookedWorld, but instead of firing callbacks, it records changes in a ChangeTracker for later querying by systems.

Example

use cougr_core::{SimpleWorld, runtime::TrackedWorld};
use soroban_sdk::{symbol_short, Bytes, Env};

let env = Env::default();
let world = SimpleWorld::new(&env);
let mut tracked = TrackedWorld::new(world);

let e1 = tracked.spawn_entity();
tracked.add_component(e1, symbol_short!("pos"), Bytes::new(&env));

assert!(tracked.tracker().was_added(e1, &symbol_short!("pos")));

Implementations

impl TrackedWorld

pub fn new(world: SimpleWorld) -> Self

Wrap a SimpleWorld with a new change tracker.

pub fn world(&self) -> &SimpleWorld

Access the underlying SimpleWorld.

pub fn world_mut(&mut self) -> &mut SimpleWorld

Mutably access the underlying SimpleWorld.

pub fn tracker(&self) -> &ChangeTracker

Access the change tracker.

pub fn tracker_mut(&mut self) -> &mut ChangeTracker

Mutably access the change tracker (e.g. to clear it).

pub fn into_inner(self) -> SimpleWorld

Consume the wrapper and return the inner SimpleWorld.

pub fn spawn_entity(&mut self) -> EntityId

Spawn a new entity (delegates to SimpleWorld).

pub fn add_component( &mut self, entity_id: EntityId, component_type: Symbol, data: Bytes, )

Add a component, recording the change.

pub fn add_component_with_storage( &mut self, entity_id: EntityId, component_type: Symbol, data: Bytes, storage: ComponentStorage, )

Add a component with explicit storage kind, recording the change.

pub fn remove_component( &mut self, entity_id: EntityId, component_type: &Symbol, ) -> bool

Remove a component, recording the change.

pub fn get_component( &self, entity_id: EntityId, component_type: &Symbol, ) -> Option<Bytes>

Get a component (delegates to SimpleWorld).

pub fn has_component( &self, entity_id: EntityId, component_type: &Symbol, ) -> bool

Check if an entity has a component (delegates to SimpleWorld).

pub fn despawn_entity(&mut self, entity_id: EntityId)

Despawn an entity, recording removals for each component.