cougr-core 1.0.0

Cougr - A Soroban-compatible ECS framework for on-chain gaming on Stellar
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94

use crate::simple_world::EntityId;
use soroban_sdk::{contracttype, Bytes, Symbol};

/// Metadata stored as a single persistent entry.
#[contracttype]
#[derive(Clone, Debug)]
pub struct WorldMetadata {
    /// Next entity ID to assign.
    pub next_entity_id: u32,
    /// Version counter for cache invalidation.
    pub version: u64,
    /// Total number of live entities.
    pub entity_count: u32,
    /// List of all live entity IDs.
    pub entity_ids: soroban_sdk::Vec<u32>,
}

/// Cached entity data loaded from persistent storage.
pub(super) struct LoadedEntity {
    pub(super) entity_id: EntityId,
    pub(super) component_types: soroban_sdk::Vec<Symbol>,
}

/// Cached component data loaded from persistent storage.
pub(super) struct LoadedComponent {
    pub(super) entity_id: EntityId,
    pub(super) component_type: Symbol,
    pub(super) data: Bytes,
}

pub(super) fn component_types_contains(
    component_types: &soroban_sdk::Vec<Symbol>,
    component_type: &Symbol,
) -> bool {
    for i in 0..component_types.len() {
        if let Some(existing) = component_types.get(i) {
            if &existing == component_type {
                return true;
            }
        }
    }
    false
}

pub(super) fn component_types_without(
    component_types: &soroban_sdk::Vec<Symbol>,
    component_type: &Symbol,
) -> soroban_sdk::Vec<Symbol> {
    let env = component_types.env().clone();
    let mut filtered = soroban_sdk::Vec::new(&env);
    for i in 0..component_types.len() {
        if let Some(existing) = component_types.get(i) {
            if &existing != component_type {
                filtered.push_back(existing);
            }
        }
    }
    filtered
}

pub(super) fn entity_ids_without(
    entity_ids: &soroban_sdk::Vec<EntityId>,
    entity_id: EntityId,
) -> soroban_sdk::Vec<EntityId> {
    let env = entity_ids.env().clone();
    let mut filtered = soroban_sdk::Vec::new(&env);
    for i in 0..entity_ids.len() {
        if let Some(existing) = entity_ids.get(i) {
            if existing != entity_id {
                filtered.push_back(existing);
            }
        }
    }
    filtered
}

pub(super) fn loaded_component_index(
    loaded_components: &[LoadedComponent],
    entity_id: EntityId,
    component_type: &Symbol,
) -> Option<usize> {
    loaded_components.iter().position(|component| {
        component.entity_id == entity_id && &component.component_type == component_type
    })
}

pub(super) fn loaded_entity_index(
    loaded_entities: &[LoadedEntity],
    entity_id: EntityId,
) -> Option<usize> {
    loaded_entities
        .iter()
        .position(|entity| entity.entity_id == entity_id)
}