O que Pinia faz?
Pinia é a biblioteca oficial de gerenciamento de estado para Vue, projetada para ser intuitiva e type-safe. Ela suporta tanto a Options API quanto a Composition API, com suporte de primeira classe para TypeScript e integração com devtools.
A skill é baseada no Pinia v3.0.4, gerada em 2026-01-28.
Referências Principais
| Tópico | Descrição | Referência |
|---|
| Stores | Definindo stores, state, getters, actions, storeToRefs, subscriptions | core-stores |
Recursos
Extensibilidade
| Tópico | Descrição | Referência |
|---|
| Plugins | Estender stores com propriedades, estado e comportamento personalizados | features-plugins |
Composabilidade
Melhores Práticas
Avançado
| Tópico | Descrição | Referência |
|---|
| SSR | Renderização no lado do servidor, hidratação de estado | advanced-ssr |
| Nuxt | Integração com Nuxt, auto-imports, melhores práticas de SSR | advanced-nuxt |
| HMR | Substituição de módulo a quente para desenvolvimento | advanced-hmr |
Recomendações Principais
- Prefira Setup Stores para lógica complexa, composables e watchers
- Use
storeToRefs() ao desestruturar state/getters para preservar a reatividade
- Actions podem ser desestruturadas diretamente - elas estão vinculadas à store
- Chame stores dentro de funções, não no escopo do módulo, especialmente para SSR
- Adicione suporte a HMR em cada store para melhor experiência de desenvolvimento
- Use
@pinia/testing para testes de componentes com stores mockadas