Struct HookedWorld 

pub struct HookedWorld { /* private fields */ }

A wrapper around SimpleWorld that fires lifecycle hooks on component mutations.

Since SimpleWorld is a #[contracttype] struct and cannot hold function pointers, this wrapper carries a separate HookRegistry alongside the world.

Example

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

fn on_add(_entity_id: u32, _ctype: &Symbol, _data: &Bytes) {}

let env = Env::default();
let world = SimpleWorld::new(&env);
let mut hooked = HookedWorld::new(world);
let entity_id = hooked.spawn_entity();
hooked.hooks_mut().on_add(symbol_short!("pos"), on_add);
hooked.add_component(entity_id, symbol_short!("pos"), Bytes::new(&env));
assert!(hooked.has_component(entity_id, &symbol_short!("pos")));

Implementations

impl HookedWorld

pub fn new(world: SimpleWorld) -> Self

Wrap a SimpleWorld with an empty hook registry.

pub fn with_hooks(world: SimpleWorld, hooks: HookRegistry) -> Self

Wrap a SimpleWorld with a pre-configured hook 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 hooks(&self) -> &HookRegistry

Access the hook registry.

pub fn hooks_mut(&mut self) -> &mut HookRegistry

Mutably access the hook 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, )

Add a component, firing on_add hooks after insertion.

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

Remove a component, firing on_remove hooks before 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)

Despawn an entity, firing on_remove hooks for each component.