Neural UI 2 admite únicamente Angular 22. Mantén alineados los paquetes del framework y utiliza CDK y schematics de la misma versión mayor. La tabla distingue los requisitos de Core de los requisitos del compilador y del runtime de Angular.
La combinación concreta verificada es Angular/CDK 22.2.2, CLI/schematics 22.2.2, TypeScript 6.0.3 y RxJS 7.8.2. Revisa tu compilador Angular antes de cambiar TypeScript.
Dependencia
Rango admitido
Cómo elegir
Angular
>=22.0.0 <23.0.0
Alinea los paquetes del framework. Versión verificada: 22.2.2.
Angular CDK
>=22.0.0 <23.0.0
Utiliza CDK 22 con Angular 22. Versión verificada: 22.2.2.
Angular schematics
>=22.0.0 <23.0.0
@angular-devkit/schematics y @schematics/angular son peers de Core. Versión verificada: 22.2.2.
Node.js
^22.22.3 || ^24.15.0 || >=26.0.0
Instala Node por separado. Node 23 y 25 quedan fuera de estos rangos.
TypeScript
>=6.0 <6.1
Rango del compilador Angular 22.2.2 verificado. Versión verificada: 6.0.3; revisa tu compilador antes de cambiar de revisión.
RxJS
^6.5.3 || ^7.4.0
Rango peer de Angular; Core no añade un peer de RxJS. Versión verificada: 7.8.2.
Ejecuta estos comandos en la carpeta que contiene package.json. node --version debe estar dentro de un rango de engines admitido. ng version identifica el framework y sus herramientas. npm ls no debe mostrar peers inválidos ni versiones mayores de Angular incompatibles.
Antes de instalar Core es normal que @neural-ui/core no aparezca en el árbol de dependencias. Después repite la comprobación para verificar Core 2.x y sus peers.
Terminal
node --version
npx ng version
npm ls @neural-ui/core @angular/core @angular/cdk @angular/cli typescript rxjs
Salta este paso si ya tienes una aplicación compatible. Este comando crea una aplicación Angular standalone con SCSS. Angular 22 utiliza detección de cambios zoneless por defecto. Elige renderizado en servidor solo si tu producto lo necesita; la guía de SSR explica esa configuración.
Terminal
npx @angular/cli@22.2.2 new neural-app --standalone --style=scss --package-manager=npm
cd neural-app
Actualiza primero la aplicación a unas herramientas compatibles con Angular 22 antes de integrar Core 2. El paquete incluye actualmente schematics de configuración y generación de páginas, pero no una migración ng-update que reescriba automáticamente templates o formularios de Neural UI 1. ng add configura, no migra.
Trabaja en una rama recuperable. Revisa imports de entrypoints públicos, selectores exactos, inputs renombrados o eliminados, eventos de modelo/propuesta, estilos y templates proyectados frente a la API de cada componente. En controles signal, sustituye los bindings antiguos formControlName/ngModel de ControlValueAccessor por FormField o el modelo documentado. Compila y prueba interacciones reales, foco y layout responsive; actualizar la dependencia no completa por sí solo esta migración.
Actualiza Angular 21 o anterior antes de añadir Core 2. Corrige las versiones mayores mezcladas y un TypeScript incompatible en las herramientas de la aplicación; no ocultes esos problemas con --force o --legacy-peer-deps. Instala Node por separado: no es una dependencia npm de la aplicación.
Un árbol de versiones válido es un requisito, no una prueba de que toda la aplicación funcione. Continúa con Instalación para cargar los estilos y renderizar un componente.
