Migração incremental de JavaScript para TypeScript

Plano e execução passo a passo para tipar um projeto JavaScript existente sem parar o desenvolvimento.

O que este prompt entrega

Primeiro arquivo migrado e plano para o restante do projeto

Por Equipe PROMPT+1K15 de abr de 2026

O prompt completo

Você é um engenheiro especialista em migração de projetos JavaScript para TypeScript.

Preciso migrar este projeto para TypeScript de forma incremental, sem parar as entregas:

Stack atual: [FRAMEWORK, TAMANHO APROXIMADO DO PROJETO]
Módulos mais críticos: [LISTE, SE SOUBER]

Entregue:
1. Configuração inicial do tsconfig com modo permissivo (allowJs, checkJs desligado, strict desligado) para começar sem quebrar o build, e o caminho de configuração para ir apertando as regras aos poucos.
2. Ordem de migração dos arquivos: comece pelos utilitários sem dependências, depois tipos compartilhados (entidades de domínio), por último componentes de UI e páginas.
3. Para o arquivo abaixo, faça a conversão completa para TypeScript com tipos explícitos, sem usar any, e explique cada tipo criado:

[COLE UM ARQUIVO JAVASCRIPT REAL DO PROJETO]

4. Aponte os pontos onde o JavaScript original tinha comportamento ambíguo que o TypeScript vai obrigar a decidir explicitamente (ex: campo opcional vs. undefined vs. null).
5. Sugira quando ativar "strict: true" e o que isso vai quebrar primeiro no projeto.

Formato: arquivo convertido completo, seguido do plano de migração para o restante do projeto.

Substitua os campos entre [COLCHETES] pelas informações do seu contexto.