orion-ecs / keen-eye / 20702626390

65%

Build Type

push

github

Committed by tyevco

Commit Message

feat(navigation): Add KeenEyes.Navigation.Abstractions package

Create the navigation abstraction layer enabling BYOP (Bring Your Own
Pathfinding) implementations. This package provides backend-agnostic
interfaces and data structures for navigation and pathfinding.

Interfaces:
- INavigationProvider: Main pathfinding API with FindPath, RequestPath, Raycast
- INavigationMesh: NavMesh data abstraction with serialization support
- IPathRequest: Async path request with status tracking

Data structures:
- NavPath: Computed path with waypoints, sampling, and metadata
- NavPoint: Point on navmesh with area type and polygon ID
- AgentSettings: Agent configuration (radius, height, slope, step height)

Components:
- NavMeshAgent: Entity navigation component with destination/steering
- NavMeshObstacle: Dynamic obstacle for navmesh carving

Enums:
- NavigationStrategy: NavMesh, Grid, Hierarchical, Custom
- NavAreaType/NavAreaMask: Area filtering for pathfinding costs
- PathRequestStatus: Async request status tracking
- ObstacleShape: Box, Cylinder

All types are Native AOT compatible with no reflection usage.

Closes #637

Coverage Stats

5364 of 6605 branches covered (81.21%)

Branch coverage included in aggregate %.

98 of 99 new or added lines in 5 files covered. (98.99%)

1 existing line in 1 file now uncovered.

34482 of 44400 relevant lines covered (77.66%)

1.11 hits per line