no-deprecated-classes

Disallow deprecated Tailwind CSS v4 classes

Qué hace esta regla

Marca cualquier clase que fue renombrada cuando Tailwind pasó de v3 a v4 y la reescribe en el lugar con un auto-fix. El mapeo es un DEPRECATED_MAP hardcodeado — sin heurísticas, sin consultas al DS sobre el nombre viejo. Ejemplos: flex-grow → grow, flex-shrink → shrink, overflow-ellipsis → text-ellipsis, decoration-clone → box-decoration-clone, bg-gradient-to-r → bg-linear-to-r (y el resto de las direcciones de gradient). Los variants y modificadores ! (important) se preservan en ambos lados de la reescritura.

No necesita design system. La regla consulta solo el DEPRECATED_MAP hardcodeado, así que corre incluso cuando settings.tailwindcss.entryPoint no está configurado, y nunca emite un diagnóstico designSystemUnavailable. Igual juega bien con el resto del plugin: no-unknown-classes reconoce los spellings viejos de v3, así que flex-grow recibe un único diagnóstico deprecated acá en vez de ese más un "unknown class" de otra regla.

Opciones

Esta regla no tiene opciones. Por compatibilidad hacia atrás todavía acepta un string entryPoint (sobrante de cuando cargaba el design system), pero el valor se ignora — la regla nunca lo lee.

Ejemplos

✗ Incorrecto

// Aliases de flex de v3 — v4 sacó el prefijo `flex-`
<div className="flex-grow flex-shrink-0" />

// Dirección de gradient — renombrada a bg-linear-to-*
<div className="bg-gradient-to-r from-blue-500 to-purple-500" />

// Alias de text overflow y shorthand de box-decoration
<div className="overflow-ellipsis" />
<div className="decoration-clone" />

// Variants e important se preservan en la salida
<div className="hover:!flex-grow" />

✓ Correcto

// Spellings post-migración
<div className="grow shrink-0" />

<div className="bg-linear-to-r from-blue-500 to-purple-500" />

<div className="text-ellipsis" />
<div className="box-decoration-clone" />

<div className="hover:!grow" />

Interacciones con otras reglas

• no-unknown-classes: omite silenciosamente cualquier clase presente en DEPRECATED_MAP. No vas a recibir "unknown class" más "deprecated class" para flex-grow — solo la deprecación. Mantén ambas activas.
• enforce-canonical: cubre un conjunto estrictamente más grande que esta regla — reescribe formas válidas-pero-no-canónicas (-m-0 → m-0, start-2 → inset-s-2) y también atrapa todas las deprecaciones. Correr ambas está bien; los autofixes no conflictúan. Elige no-deprecated-classes cuando quieres un pase rápido sobre la lista fija de renames v3→v4; elige enforce-canonical para el cleanup completo con DS.
• no-restricted-classes: ortogonal. Esa la usas para bloquear clases válidas; esta solo se dispara con la lista fija de renames v3→v4.

Cuándo desactivarla

• Sigues en Tailwind v3 y quieres mantener los spellings de v3. Desactiva esta regla hasta que migres.
• Mantienes a propósito una capa de clases v3-compatibles al lado de v4 (por ejemplo, una librería compartida que apunta a ambos). En ese caso prefiere un eslint-disable puntual en el archivo antes que un disable a nivel proyecto.