Pular para o conteúdo
UseIA
0
Skill

Vercel Composition Patterns

Crédito: vercel-labs no GitHub (vercel-labs/agent-skills) · 0 cópias

Indicada na UseIA por Cristiano Rochenbach Abreu em 5 de out. de 2026

32 mil estrelas no GitHubVer no GitHub
Salvar

Tradução feita por IA. Em caso de dúvida, vale o texto original (aba “Original”).

---
name: vercel-composition-patterns
description:
  Padrões de composição em React que escalam. Use ao refatorar componentes com
  proliferação de props booleanas, ao construir bibliotecas de componentes
  flexíveis ou ao projetar APIs reutilizáveis. Acionada em tarefas que envolvem
  componentes compostos, render props, context providers ou arquitetura de
  componentes. Inclui as mudanças de API do React 19.
license: MIT
metadata:
  author: vercel
  version: '1.0.0'
---

# React Composition Patterns

Padrões de composição para construir componentes React flexíveis e de fácil manutenção. Evite a proliferação de props booleanas usando componentes compostos, elevando o estado e compondo as partes internas. Esses padrões tornam as bases de código mais fáceis de trabalhar, tanto para humanos quanto para agentes de IA, à medida que crescem.

## Quando aplicar

Consulte estas diretrizes quando:

- Refatorar componentes com muitas props booleanas
- Construir bibliotecas de componentes reutilizáveis
- Projetar APIs de componentes flexíveis
- Revisar a arquitetura de componentes
- Trabalhar com componentes compostos ou context providers

## Categorias de regras por prioridade

| Prioridade | Categoria                | Impacto | Prefixo         |
| ---------- | ------------------------ | ------- | --------------- |
| 1          | Arquitetura de componentes | ALTO  | `architecture-` |
| 2          | Gerenciamento de estado  | MÉDIO   | `state-`        |
| 3          | Padrões de implementação | MÉDIO   | `patterns-`     |
| 4          | APIs do React 19         | MÉDIO   | `react19-`      |

## Referência rápida

### 1. Arquitetura de componentes (ALTO)

- `architecture-avoid-boolean-props` - Não adicione props booleanas para personalizar
  o comportamento; use composição
- `architecture-compound-components` - Estruture componentes complexos com contexto
  compartilhado

### 2. Gerenciamento de estado (MÉDIO)

- `state-decouple-implementation` - O Provider é o único lugar que sabe como o
  estado é gerenciado
- `state-context-interface` - Defina uma interface genérica com state, actions e meta
  para injeção de dependência
- `state-lift-state` - Mova o estado para componentes provider para acesso entre irmãos

### 3. Padrões de implementação (MÉDIO)

- `patterns-explicit-variants` - Crie componentes de variante explícitos em vez de
  modos booleanos
- `patterns-children-over-render-props` - Use children para composição em vez de
  props renderX

### 4. APIs do React 19 (MÉDIO)

> **⚠️ Somente React 19+.** Pule esta seção se estiver usando React 18 ou anterior.

- `react19-no-forwardref` - Não use `forwardRef`; use `use()` em vez de `useContext()`

## Como usar

Leia os arquivos de regras individuais para explicações detalhadas e exemplos de código:

```
rules/architecture-avoid-boolean-props.md
rules/state-context-interface.md
```

Cada arquivo de regra contém:

- Uma breve explicação de por que ela importa
- Um exemplo de código incorreto, com explicação
- Um exemplo de código correto, com explicação
- Contexto adicional e referências

## Documento compilado completo

Para o guia completo com todas as regras expandidas: `AGENTS.md`