# @nebula/core-navigation

Focus management and spatial navigation primitives for controller-first UIs.

## Why it exists
Directional navigation needs predictable, consistent logic for TVs and handhelds. This package provides small, testable functions that you can plug into any UI layer.

## Usage

```js
import { pickBestCandidate } from "@nebula/core-navigation";

const current = { id: "settings", x: 100, y: 100, width: 180, height: 80 };
const candidates = [
  { id: "play", x: 100, y: 10, width: 180, height: 80 },
  { id: "help", x: 320, y: 100, width: 180, height: 80 }
];

const next = pickBestCandidate(current, candidates, "up");
```

## SteamOS / Steam Deck notes
Use these primitives to drive focus on elements that are at least 8–10mm tall on a TV. Combine with large hit targets and visible focus rings.