# @oshun/navigation

Typed route contracts and link helpers for OSHUN mobile, web, and deep links.

## Includes

- Unified route registry (`OSHUN_ROUTE_MAP`) for shell + domain routes
- Typed shell route definitions (`home`, `explore`, `activity`, `profile`)
- Typed domain route definitions (Tara, Veritas, Nyx, Arete, Nisaba, Metis)
- Customer-shell IA contract for Tara-centered surfaces and companion domains
- Tara experiential-spine helper and shell role labels for center/companion copy
- Canonical `oshun://{domain|surface}/{path}` deep-link builders/parsers
- Canonical HTTPS link builders/parsers (`/app/{surface}`, `/d/{domain}/{path}`)

## Nx Targets

- `pnpm nx run @oshun/navigation:build`
- `pnpm nx run @oshun/navigation:lint`
- `pnpm nx run @oshun/navigation:typecheck`
- `pnpm nx run @oshun/navigation:test`