Migrar código JavaScript para TypeScript estrito sem partir nada

Prompt

Atua como engenheiro sénior de TypeScript que já migrou grandes bases de código JavaScript de forma incremental.

Contexto:
- Código a migrar: {{codigo_js}}
- Projeto e ferramentas de build: {{projeto}}
- Nível de rigor: {{rigor}}
- Ambiente de execução: {{ambiente}}

Se o código importar módulos que não mostrei ou receber dados de forma pouco clara, pergunta-me antes de inventares tipos.

Entregáveis:
1. Um tsconfig.json recomendado para {{rigor}}, explicando as opções principais (strict, noUncheckedIndexedAccess, allowJs, checkJs, module e moduleResolution conforme o build).
2. O código convertido para TypeScript, com tipos e interfaces deduzidos do uso real. Marca cada tipo suposto com um comentário `// PRESSUPOSTO:`.
3. Dados externos (respostas de API, localStorage, JSON) tipados como `unknown` e validados ou restringidos antes do uso.
4. Lista de erros ou comportamentos duvidosos que os tipos revelaram (possíveis undefined, comparações entre tipos diferentes, argumentos opcionais mal tratados), com a linha e a correção proposta, separada da conversão.
5. Os pacotes @types necessários e alterações nos scripts do package.json ou na configuração do ESLint.
6. Plano para migrar o resto do projeto: ordem dos ficheiros (das folhas para a raiz), como conviver com JS durante a transição e como evitar que os `any` voltem.

Restrições:
- Mantém exatamente o comportamento; não refatores a lógica no mesmo passo.
- Proibido `any`, `as any`, `@ts-ignore` e asserções não nulas `!` sem justificação escrita.
- Se uma correção alterar o comportamento, propõe-na à parte e não a apliques.
- Usa [PREENCHER] para o que não puder ser deduzido.

Formato: tsconfig, código convertido, lista de achados e plano, cada um na sua secção.

Como utilizar

Exemplo de utilização

Exemplo de resultado

// PRESSUPOSTO: forma deduzida do uso no ficheiro original
export interface ItemCarrinho {
  readonly id: string;
  preco: number;
  quantidade: number;
}

export function totalCarrinho(itens: readonly ItemCarrinho[], descontoPct = 0): number {
  const subtotal = itens.reduce((soma, item) => soma + item.preco * item.quantidade, 0);
  return subtotal * (1 - descontoPct / 100);
}

export function carregarCarrinho(): ItemCarrinho[] {
  const bruto: unknown = JSON.parse(localStorage.getItem('carrinho') ?? '[]');
  return Array.isArray(bruto) ? bruto.filter(eItemCarrinho) : [];
}

function eItemCarrinho(valor: unknown): valor is ItemCarrinho {
  if (typeof valor !== 'object' || valor === null) return false;
  const v = valor as Record<string, unknown>;
  return typeof v.id === 'string' && typeof v.preco === 'number' && typeof v.quantidade === 'number';
}

Dados-chave

Categoria

Programação e desenvolvimento · TypeScript

Tipo de resultado

Código

Nível

Intermédio

Pensado para

ChatGPT, Claude, Gemini e Microsoft Copilot

Verificado em

Pendente de verificação editorial

Variáveis

Código JavaScript, Projeto e build, Nível de rigor e Ambiente de execução

Idioma

Português

Preço

Gratuito, sem registo

Atualizado

07/11/2026

Perguntas frequentes