orion-ecs / keen-eye / 19984042158

65%

push

github

Add entity naming support with Spawn(name), GetName, GetEntityByName

Implements GitHub issue #58 - Entity Naming Support

Features:
- World.Spawn(string? name) overload for creating named entities
- World.GetName(Entity) for retrieving entity names
- World.GetEntityByName(string) for reverse lookup by name
- Bidirectional Dictionary storage for O(1) lookups both ways
- Automatic name cleanup on Despawn
- Unique name enforcement with ArgumentException on duplicates

Implementation details:
- Added entityNames and namesToEntityIds dictionaries to World
- EntityBuilder tracks optional name and passes it to CreateEntity
- Despawn cleans up both name mappings when entity is destroyed
- Dispose clears name dictionaries along with other state
- Stale entity handles return null from GetName (safe pattern)

Tests:
- 35 comprehensive tests covering all naming scenarios
- Spawn with/without names, duplicate name handling
- GetName for named, unnamed, stale, and invalid entities
- GetEntityByName including case sensitivity and edge cases
- Despawn cleanup verification and name reuse after despawn
- Integration tests with components and queries
- Edge cases: empty strings, unicode, special characters

28 of 29 new or added lines in 2 files covered. (96.55%)

674 of 710 relevant lines covered (94.93%)

0.95 hits per line