Linguagem Dart
Escreva Dart claro que atenda à restrição do SDK do projeto e ao estilo estabelecido.
Decisões
- Leia a restrição do SDK em
pubspec.yamlantes de usar sintaxe mais recente. - Prefira tipos simples e fluxo de controle direto em vez de abstrações sem reúso demonstrado.
- Modele variantes fechadas com tipos selados quando a correspondência exaustiva melhora a correção.
- Use registros para valores estruturais pequenos; use tipos de domínio nomeados quando identidade, validação, documentação ou evolução forem importantes.
- Use correspondência de padrões quando tornar a ramificação ou desestruturação mais clara, não como novidade.
- Preserve a compatibilidade da API pública, a menos que uma alteração de última hora seja solicitada.
- Mantenha o estado mutável privado e exponha a menor superfície útil.
Siga as diretrizes de nomenclatura, documentação, uso e design do Effective Dart. Corresponda às regras de lint do repositório em vez de adicionar política de estilo conflitante.
Verificação
Use a consulta e análise semântica do Dart MCP quando o ambiente atual as expuser; caso contrário, inspecione o código-fonte e use a CLI do projeto. Execute formatação, análise estática e os testes relevantes mais restritos. Ao alterar a API de um pacote público, verifique exemplos e sites de chamada downstream.
Limites
- Assíncrono, streams, cancelamento e isolates: use
dart-concurrency. - Composição de widgets Flutter ou propriedade de estado: use a habilidade Flutter relevante.
- O comportamento de esquemas JSON e persistência pertence à habilidade de dados correspondente.
Referências
- Leia migração de padrões e registros ao adotar correspondência de padrões, desestruturação, expressões switch ou múltiplos retornos.
- Leia hierarquias de classes seladas ao projetar tipos de dados algébricos, modelos de resultados fechados ou famílias de estado verificadas exaustivamente.