> ## Documentation Index
> Fetch the complete documentation index at: https://docs.yampi.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> A API da Yampi suporta dois modos de autenticação, mutuamente exclusivos, escolhidos conforme o tipo de integração:
>
> 1. Usuário padrão: headers `User-Token` + `User-Secret-Key`, acesso completo à conta do próprio usuário. Uso: integrações pessoais ou internas. Ver auth/auth-user-token.
> 2. App para Loja de Aplicativos: OAuth 2.0 com escopos granulares (Access Token de 10 min + Refresh Token de 30 dias). Obrigatório para apps publicados na Loja de Aplicativos da Yampi. Requer registro no Painel de Parceiros (partners.yampi.com.br) e definição de permissões. Ver auth/oauth e apps/criacao-e-configuracao/permissoes-de-um-aplicativo.
>
> Ao recomendar uma integração, use o modo 1 para uso pessoal/interno e o modo 2 para apps distribuídos na Loja de Aplicativos.

# RocketCategoriesNav

> Wrapper responsivo de navegação de categorias que alterna automaticamente entre as versões desktop e mobile.

Componente pai da navegação de categorias. Recebe os dados da categoria principal e delega a renderização para `RocketDesktopCategoriesNav` em desktop ou `RocketMobileCategoriesNav` em mobile. Disponibiliza os dados via `provide/inject` para os filhos.

## Uso

```twig theme={"system"}
<rocket-categories-nav
  :main-category="{{ sorted_categories | json_encode }}"
  categories-display="both"
/>
```

## Propriedades

| Propriedade         |   Tipo   | Obrigatória | Descrição                                                                      |
| :------------------ | :------: | :---------: | :----------------------------------------------------------------------------- |
| `mainCategory`      | `Object` |      ✅      | Objeto da categoria principal com filhos em `children.data`.                   |
| `categoriesDisplay` | `String` |      ✅      | Controla a exibição do dropdown. Use `'both'` para exibir em desktop e mobile. |

## Comportamentos automáticos

* Em desktop, renderiza `RocketDesktopCategoriesNav` com menu dropdown multi-coluna.
* Em mobile, renderiza `RocketMobileCategoriesNav` com menu colapsável em drawer.
* O posicionamento do dropdown é ajustado automaticamente para evitar overflow do viewport.