Habilidad: animate-ui
Contrato de Activación
Usa esta habilidad cuando:
- Estés agregando o personalizando componentes de interfaz de usuario animados utilizando la distribución Animate UI.
- Estés implementando patrones potenciados por Motion (Framer Motion) en un proyecto shadcn/ui.
- Estés configurando el registro de Animate UI o agregando primitivas/componentes específicos.
Reglas Estrictas
- Enfoque de Copia: Siempre trata los componentes como "código abierto" para copiar y modificar, no como importaciones fijas de biblioteca.
- Verificación de Dependencias: Asegúrate de que
motion,tailwind-merge,clsxylucide-reactestén instalados antes de agregar componentes. - Convención de Nombres: Sigue el patrón
@animate-ui/{categoría}-{subcategoría}-{nombre}para los comandos de la CLI de shadcn. - Rutas de Importación: Usa por defecto
@/components/animate-ui/para todos los componentes y primitivas agregados. - Stack Estándar: Usa React, Tailwind CSS y Framer Motion (Motion).
Puertas de Decisión
| Tarea | Acción |
|---|---|
| Nuevo Proyecto | Ejecuta npx shadcn@latest init y luego configura Tailwind/Motion. |
| Agregar Primitiva | Usa npx shadcn@latest add @animate-ui/primitives-{categoría}-{nombre}. |
| Agregar Componente | Usa npx shadcn@latest add @animate-ui/components-{categoría}-{nombre}. |
| Movimiento Personalizado | Extiende componentes existentes usando props de motion (ej., whileHover, transition). |
Pasos de Ejecución
- Verificar Requisitos Previos: Revisa si
framer-motion(omotion) ytailwind-mergeestán enpackage.json. - Configuración Inicial: Si aún no se ha hecho, sigue el proceso de inicialización de
shadcn/ui. - Selección del Componente: Identifica si necesitas una primitiva (lógica + movimiento básico) o un componente (pieza de interfaz estilizada).
- Instalación: Usa la CLI de shadcn con los nombres de paquete con ámbito
@animate-ui. - Integración: Importa desde
@/components/animate-ui/...y pasa las props necesarias. - Pulido: Ajusta las transiciones de muelle (stiffness, damping) para que coincidan con la sensación del proyecto.
Contrato de Salida
- Lista de componentes agregados mediante la CLI de shadcn.
- Rutas de importación verificadas en la implementación.
- Explicación de los ajustes de movimiento personalizados, si los hay.
Referencias
references/getting-started.md— Guía de instalación y configuración.references/components.md— Categorías y convenciones de nombres.references/motion-patterns.md— Configuraciones comunes de muelle y transición.