Migrar código JavaScript a TypeScript estricto sin romper nada

Prompt

Actúa como ingeniero sénior de TypeScript que ha migrado bases de código JavaScript grandes de forma incremental.

Contexto:
- Código a migrar: {{codigo_js}}
- Proyecto y herramientas de build: {{proyecto}}
- Nivel de rigor: {{rigor}}
- Entorno de ejecución: {{entorno}}

Si el código importa módulos que no veo o recibe datos cuya forma no está clara, pregúntame antes de inventar tipos.

Entregables:
1. Un tsconfig.json recomendado para {{rigor}}, explicando las opciones clave (strict, noUncheckedIndexedAccess, allowJs, checkJs, module y moduleResolution según el build).
2. El código convertido a TypeScript, con tipos e interfaces deducidos del uso real. Marca con un comentario `// SUPUESTO:` cada tipo que hayas tenido que suponer.
3. Datos externos (respuestas de API, localStorage, JSON) tipados como `unknown` y validados o estrechados antes de usarse.
4. Lista de errores o comportamientos dudosos que los tipos han destapado (posibles undefined, comparaciones de tipos distintos, argumentos opcionales mal tratados), con la línea y la corrección propuesta, separada de la conversión.
5. Los paquetes @types necesarios y cambios en scripts de package.json o en la configuración de ESLint.
6. Plan para migrar el resto del proyecto: orden de los archivos (de las hojas a la raíz), cómo convivir con JS durante la transición y cómo evitar que vuelvan a aparecer `any`.

Restricciones:
- Conserva exactamente el comportamiento; no refactorices la lógica en el mismo paso.
- Prohibido `any`, `as any`, `@ts-ignore` y aserciones no nulas `!` sin una justificación escrita.
- Si una corrección cambia el comportamiento, proponla aparte y no la apliques.
- Usa [COMPLETAR] para lo que no se pueda deducir.

Formato: tsconfig, código convertido, lista de hallazgos y plan, cada uno en su sección.

Cómo usarlo

Ejemplo de uso

Resultado de ejemplo

// SUPUESTO: forma deducida del uso en el archivo original
export interface ItemCarrito {
  readonly id: string;
  precio: number;
  cantidad: number;
}

export function totalCarrito(items: readonly ItemCarrito[], descuentoPct = 0): number {
  const subtotal = items.reduce((suma, item) => suma + item.precio * item.cantidad, 0);
  return subtotal * (1 - descuentoPct / 100);
}

export function cargarCarrito(): ItemCarrito[] {
  const raw: unknown = JSON.parse(localStorage.getItem('carrito') ?? '[]');
  return Array.isArray(raw) ? raw.filter(esItemCarrito) : [];
}

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

Datos clave

Categoría

Programación y desarrollo · TypeScript

Tipo de resultado

Código

Nivel

Intermedio

Pensado para

ChatGPT, Claude, Gemini y Microsoft Copilot

Verificado en

Pendiente de verificación editorial

Variables

Código JavaScript, Proyecto y build, Nivel de rigor y Entorno de ejecución

Idioma

Español

Precio

Gratis, sin registro

Actualizado

07/11/2026

Preguntas frecuentes