rn-typescript

React Native — TypeScript

Objetivo

Garantir segurança de tipos de ponta a ponta, tornando estados inválidos irrepresentáveis.

Quando utilizar

• Tipar props, hooks, stores, respostas de API e navegação.
• Modelar estados de carregamento/erro/sucesso.
• Endurecer o tsconfig ou remover any de uma base existente.

Conhecimentos necessários

• strict mode e flags relacionadas (noImplicitAny, strictNullChecks).
• Unions discriminadas, generics e utility types (Pick, Omit, Partial, Record).
• unknown vs any; type guards e narrowing.
• Inferência vs anotação explícita.

Fluxo de execução

1. Habilite strict: true no tsconfig.
2. Modele dados com tipos/interfaces explícitos; tipe props no parâmetro da função.
3. Represente estados variantes com union discriminada ({ type: 'success'; data } | { type: 'error'; error }).
4. Trate entradas externas como unknown e faça narrowing/validação antes de usar.
5. Rode tsc --noEmit e elimine erros; sem any ou @ts-ignore.

Boas práticas

• Prefira type para unions/props; interface para contratos extensíveis.
• Derive tipos de fontes únicas (schemas, constantes as const) para evitar drift.
• Torne ilegais os estados inválidos via tipos, não via checagem em runtime.
• Exporte tipos de saída reutilizados por mappers e casos de uso.

Armadilhas comuns

• any implícito em callbacks e respostas de API.
• Casts (as) mascarando modelagem incorreta.
• Enums onde uma union de strings basta.
• React.FC (tipagem implícita de children indesejada).

Critérios de sucesso

• tsc --noEmit sem erros; zero any/@ts-ignore injustificados.
• Estados inválidos não compilam.
• Autocompletar e refactors seguros em toda a base.