Struct ObservedWorld 

pub struct ObservedWorld { /* private fields */ }

A wrapper around SimpleWorld that fires observers on component mutations.

Observers receive read-only access to the world after the mutation completes, allowing them to see the updated state.

Example

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

fn my_observer(_event: &ComponentEvent, _world: &SimpleWorld, _env: &Env) {}

let env = Env::default();
let world = SimpleWorld::new(&env);
let mut observed = ObservedWorld::new(world);
let entity_id = observed.spawn_entity();
observed.observers_mut().on_add(symbol_short!("pos"), my_observer);
observed.add_component(entity_id, symbol_short!("pos"), Bytes::new(&env), &env);
assert!(observed.world().has_component(entity_id, &symbol_short!("pos")));

Implementations

impl ObservedWorld

pub fn new(world: SimpleWorld) -> Self

Wrap a SimpleWorld with an empty observer registry.

pub fn with_observers(world: SimpleWorld, observers: ObserverRegistry) -> Self

Wrap a SimpleWorld with a pre-configured observer registry.

pub fn world(&self) -> &SimpleWorld

Access the underlying SimpleWorld.

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

Mutably access the underlying SimpleWorld.

pub fn observers(&self) -> &ObserverRegistry

Access the observer registry.

pub fn observers_mut(&mut self) -> &mut ObserverRegistry

Mutably access the observer registry.

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, env: &Env, )

Add a component, firing on_add observers after insertion.

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

Remove a component, firing on_remove observers after removal.

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, env: &Env)

Despawn an entity, firing on_remove observers for each component.