orion-ecs / keen-eye / 19984139392

65%

push

github

Add singleton/resource system for world-level data

Implements issue #59 - a singleton/resource system for storing world-level
data not tied to entities (time, input, config, global state).

New World methods:
- SetSingleton<T>(in T value): Stores or updates a singleton value
- GetSingleton<T>(): Returns ref T for zero-copy access; throws if missing
- TryGetSingleton<T>(out T value): Safe accessor returning bool
- HasSingleton<T>(): Checks if singleton exists
- RemoveSingleton<T>(): Removes singleton, returns bool indicating success

Key implementation details:
- Storage uses Dictionary<Type, object> (boxing acceptable for O(1) access)
- GetSingleton returns ref via Unsafe.Unbox<T>() for zero-copy modification
- Per-world storage (not global static) maintains world isolation
- Singletons cleared in Dispose() method

Includes 50+ comprehensive unit tests covering:
- Basic CRUD operations for all five methods
- World isolation (singletons don't leak between worlds)
- Integration with entity operations
- Edge cases and idempotency

16 of 16 new or added lines in 1 file covered. (100.0%)

690 of 726 relevant lines covered (95.04%)

0.95 hits per line