@silvestv/migration-planificator 7.1.0 → 7.1.2

package/dist/src/data/rules/to19/rules-19-obligatoire.json

@@ -5,14 +5,16 @@
     "description": "Angular 19 requiert Node.js 20.18.1 ou supérieur et TypeScript 5.5+. Cette version introduit les linked signals, le support amélioré du zoneless, et un nouveau système de schematics. Les versions antérieures ne sont plus compatibles.",
     "estimated_time_per_occurrence": 20,
     "onFile": "package.json",
+    "routineType": "environment-migration",
     "fileTypes": ["package.json"],
     "regex": "\"@angular/(core|cli)\"\\s*:\\s*\"(?:(?:\\^|~)?1[0-8](?:\\.\\d+){0,2})\"",
     "category": "environment",
-    "isAutoFixable": false,
+    "isAutoFixable": true,
+    "minAngularVersion": 18,
     "migration_command": "npx ng update @angular/core@19 @angular/cli@19",
-    "nxMigrationCommand": "npx nx migrate @angular/core@19 @angular/cli@19 && npx nx migrate --run-migrations",
+    "nxMigrationCommand": "npx nx migrate nx@20.8.4 && npm install && npm install typescript@~5.5.4 && npx nx migrate --run-migrations",
     "risk_level": "high",
-    "code_description": "// Migration Angular 19\n// Node : >= 20.18.1\n// TypeScript : ~5.5.0\n// Commande Angular CLI :\n//   npx ng update @angular/core@19 @angular/cli@19\n// Commande Nx :\n//   npx nx migrate @angular/core@19 @angular/cli@19 && npx nx migrate --run-migrations",
+    "code_description": "// Migration Angular 18 → 19 (Nx)\n// 1. npx nx migrate nx@20.8.4\n// 2. Mettre à jour deps tierces Angular dans package.json vers @19 + !!! Bonne version de typescript si non spécifié !!!\n// 3. npm install && npm install typescript@~5.5.4\n// 4. npx nx migrate --run-migrations",
     "doc_url": "https://angular.dev/reference/migrations"
   },
   {
@@ -26,7 +28,8 @@
     ],
     "regex": "\"engines\"\\s*:\\s*\\{[^}]*\"node\"\\s*:\\s*\"(?:(?:[<>=~^]*)(1[0-9]|20\\.(?:[0-9]|1[0-7])(?:\\.[0-9]+)?))\"",
     "category": "environment",
-    "isAutoFixable": false,
+    "isAutoFixable": true,
+    "minAngularVersion": 19,
     "migration_command": null,
     "risk_level": "high",
     "code_description": "// Vérifier et mettre à jour Node.js\n// Avant: Node v16.x\n// Après: Node v20.18.1+\n// Commande: node --version",
@@ -44,6 +47,7 @@
     "regex": "^(?![\\s\\S]*\"typescript\"[\\s\\S]*\"[<>=~^]*(?:5\\.[5-9]|[6-9]\\d*)\\.)[\\s\\S]+",
     "category": "environment",
     "isAutoFixable": true,
+    "minAngularVersion": 19,
     "migration_command": "npm install typescript@~5.5.0",
     "risk_level": "medium",
     "code_description": "// package.json\n// Avant: \"typescript\": \"~5.4.0\"\n// Après: \"typescript\": \"~5.5.0\"",
@@ -51,19 +55,20 @@
   },
   {
     "key": "standalone_default",
-    "summary": "Angular 19 : standalone est maintenant true par défaut – ajoutez standalone: false ou migrez",
-    "description": "BREAKING CHANGE MAJEUR : Angular 19 définit `standalone: true` comme valeur par défaut. Les composants/directives/pipes déclarés dans un NgModule (via la propriété 'declarations') causeront une erreur de build : 'Component X is standalone, and cannot be declared in an NgModule'. Solution : ajouter explicitement `standalone: false` à chaque composant déclaré OU migrer vers l'architecture standalone via les schematics officiels Angular.",
+    "summary": "Angular 19 : standalone est maintenant true par défaut",
+    "description": "BREAKING CHANGE MAJEUR : Angular 19 définit `standalone: true` comme valeur par défaut. Les composants/directives/pipes déclarés dans un NgModule (via la propriété 'declarations') causeront une erreur de build : 'Component X is standalone, and cannot be declared in an NgModule'. Solution recommandée : migrer vers l'architecture standalone via les schematics officiels Angular.",
     "estimated_time_per_occurrence": 1,
     "fileTypes": [
       "*.ts"
     ],
     "regex": "declarations:\\s*\\[",
     "category": "architecture",
-    "isAutoFixable": false,
+    "isAutoFixable": true,
+    "minAngularVersion": 16,
     "migration_command": "npx ng g @angular/core:standalone --mode=convert-to-standalone --path=./ && npx ng g @angular/core:standalone --mode=prune-ng-modules --path=./ && npx ng g @angular/core:standalone --mode=standalone-bootstrap --path=./",
     "nxMigrationCommand": "npx nx g @angular/core:standalone --mode=convert-to-standalone --path=./ && npx nx g @angular/core:standalone --mode=prune-ng-modules --path=./ && npx nx g @angular/core:standalone --mode=standalone-bootstrap --path=./",
     "risk_level": "critical",
-    "code_description": "// ⚠️ BREAKING : standalone est true par défaut à partir de v19\n// Les composants déclarés dans un NgModule causent une erreur de build\n\n// Avant (Angular ≤18) - Fonctionne :\n@NgModule({\n  declarations: [AppComponent, UserComponent],\n  imports: [CommonModule]\n})\nexport class AppModule {}\n\n@Component({ selector: 'app-root' })\nexport class AppComponent {}  // Implicitement standalone: false\n\n// Angular 19 - ERREUR : \"Component AppComponent is standalone, and cannot be declared in an NgModule\"\n\n// Option 1 : Ajout explicite standalone: false (fix temporaire)\n@Component({\n  selector: 'app-root',\n  standalone: false  // ✅ Explicite\n})\nexport class AppComponent {}\n\n// Option 2 : Migration complète vers standalone (recommandée)\n// ng g @angular/core:convert-to-standalone\n// ng g @angular/core:remove-ng-modules\n// ng g @angular/core:bootstrap-standalone",
+    "code_description": "// BREAKING : standalone est true par défaut à partir de v19\n\n// Avant (Angular 18) - Fonctionne :\n@NgModule({\n  declarations: [AppComponent, UserComponent]\n})\nexport class AppModule {}\n\n// Angular 19 - ERREUR :\n// \"Component AppComponent is standalone, and cannot be declared in an NgModule\"\n\n// Solution : Migrer vers standalone\n@Component({\n  standalone: true,\n  imports: [CommonModule, RouterOutlet]\n})\nexport class AppComponent {}",
     "astPattern": {
       "nodeType": "Decorator",
       "name": "NgModule",
@@ -84,7 +89,183 @@
       "fileTypes": ["*.module.ts"],
       "timePerOccurrence": 25
     },
-    "doc_url": "https://angular.dev/reference/migrations/standalone"
+    "doc_url": "https://angular.dev/reference/migrations/standalone",
+    "ai_specification": {
+      "isComplex": true,
+      "criticalNote": "Le schematic Angular ne migre que 90-95% des cas. Une étude de cas post-schematic est OBLIGATOIRE.",
+      "knownLimitations": [
+        "SharedModule (importé par plusieurs modules)",
+        "CoreModule (contient providers globaux)",
+        "Modules avec RouterModule.forChild()",
+        "Modules avec providers NGRX (StoreModule.forFeature)",
+        "Modules tiers (Material, etc.)",
+        "Modules avec bootstrap:[] (AppModule, BrowserModule) - Mode 2 ne les supprime JAMAIS",
+        "Pattern bootstrap non-standard (IIFE, async wrapper, lazy bootstrap) - Mode 3 échoue silencieusement",
+        "SSR avec CommonEngine + ServerModule - Migration séparée nécessaire",
+        "Providers Firebase avec factory inject() - Réécriture manuelle",
+        "Tokens custom (ENVIRONMENT, CONFIG) - Extraction vers app.config.ts"
+      ],
+      "stages": [
+        {
+          "number": 1,
+          "name": "PRE-SCHEMATIC",
+          "description": "Préparer le code pour la migration automatique",
+          "actions": [
+            {
+              "instruction": "SUPPRIMER tous les `standalone: false` explicites des @Component/@Directive/@Pipe",
+              "codeExample": "// AVANT:\n@Component({ selector: 'app-user', standalone: false })\n\n// APRES:\n@Component({ selector: 'app-user' })"
+            },
+            {
+              "instruction": "EXCEPTION : Ne pas toucher si commentaire in-code indique de ne pas migrer",
+              "codeExample": "// Commentaires à respecter:\n// DO NOT MIGRATE\n// KEEP MODULE\n// NO STANDALONE"
+            },
+            {
+              "instruction": "Exécuter les 3 schematics SEQUENTIELLEMENT (attendre la fin de chaque commande avant la suivante)",
+              "codeExample": "ng g @angular/core:standalone --mode=convert-to-standalone --path=./\nng g @angular/core:standalone --mode=prune-ng-modules --path=./\nng g @angular/core:standalone --mode=standalone-bootstrap --path=./",
+              "codeLang": "bash"
+            }
+          ]
+        },
+        {
+          "number": 2,
+          "name": "POST-SCHEMATIC - ETUDE DE CAS",
+          "description": "Analyser ce que le schematic n'a pas migré",
+          "actions": [
+            {
+              "instruction": "Rechercher tous les @NgModule restants dans le projet",
+              "codeExample": "grep -r \"@NgModule\" --include=\"*.ts\" .",
+              "codeLang": "bash"
+            },
+            {
+              "instruction": "Vérifier si le bootstrap a été migré (main.ts ou main.browser.ts)",
+              "codeExample": "// SI bootstrapApplication() existe → OK\n// SI platformBrowserDynamic().bootstrapModule() persiste → Mode 3 a échoué\n\n// Patterns NON reconnus par le schematic:\n// - IIFE wrapper: (async () => { bootstrapModule(...) })()\n// - Async wrapper: async function bootstrap() {...}\n// - Condition: if (condition) { bootstrapModule(...) }\n// → Migration manuelle obligatoire vers bootstrapApplication()"
+            },
+            {
+              "instruction": "Pour chaque module trouvé, déterminer pourquoi il n'a pas été supprimé",
+              "codeExample": "// Causes fréquentes:\n// - declarations non vide\n// - bootstrap: [Component] présent (AppModule)\n// - RouterModule.forChild()\n// - providers avec forRoot/forFeature\n// - imports par plusieurs autres modules"
+            },
+            {
+              "instruction": "Documenter dans le ledger les modules restants et la stratégie de migration"
+            }
+          ]
+        },
+        {
+          "number": 3,
+          "name": "MIGRATION MANUELLE DES MODULES",
+          "description": "Migrer manuellement chaque type de module restant",
+          "actions": [
+            {
+              "instruction": "A) SUPPRIMER SharedModule : Rendre chaque composant/directive/pipe standalone, importer directement là où utilisé",
+              "codeExample": "@Component({ standalone: true, imports: [...] })\nexport class MySharedComponent {}\n\n// Puis supprimer shared.module.ts"
+            },
+            {
+              "instruction": "B) MIGRER CoreModule vers provideCore()",
+              "codeExample": "// AVANT:\n@NgModule({ providers: [MyService, {provide: HTTP_INTERCEPTORS, ...}] })\nexport class CoreModule {}\n\n// APRES:\nexport function provideCore(): Provider[] {\n  return [\n    MyService,\n    { provide: HTTP_INTERCEPTORS, multi: true, useClass: AuthInterceptor }\n  ];\n}\n// Dans app.config.ts: providers: [provideCore()]"
+            },
+            {
+              "instruction": "C) MIGRER RouterModule.forChild() vers fichier routes standalone",
+              "codeExample": "// AVANT (feature.module.ts):\n@NgModule({ imports: [RouterModule.forChild(routes)] })\n\n// APRES (feature.routes.ts):\nexport const FEATURE_ROUTES: Routes = [...];\n\n// Dans app.routes.ts:\n{ path: 'feature', loadChildren: () => import('./feature.routes').then(m => m.FEATURE_ROUTES) }"
+            },
+            {
+              "instruction": "D) MIGRER NGRX vers providers fonctionnels",
+              "codeExample": "// Dans les routes:\nproviders: [\n  provideState(featureState),\n  provideEffects(FeatureEffects)\n]"
+            },
+            {
+              "instruction": "E) MODULES TIERS : Utiliser importProvidersFrom()",
+              "codeExample": "// Dans app.config.ts:\nproviders: [importProvidersFrom(SomeThirdPartyModule.forRoot())]"
+            },
+            {
+              "instruction": "F) MIGRER BOOTSTRAP MANUELLEMENT (si Mode 3 a échoué)",
+              "codeExample": "// AVANT (main.ts avec IIFE ou pattern custom):\n(async () => {\n  await platformBrowserDynamic().bootstrapModule(AppModule);\n})();\n\n// APRES (main.ts standalone):\nimport { bootstrapApplication } from '@angular/platform-browser';\nimport { AppComponent } from './app/app.component';\nimport { appConfig } from './app/app.config';\n\nbootstrapApplication(AppComponent, appConfig)\n  .catch(err => console.error(err));\n\n// app.config.ts:\nexport const appConfig: ApplicationConfig = {\n  providers: [\n    provideRouter(routes),\n    provideHttpClient(),\n    // ... autres providers depuis AppModule\n  ]\n};"
+            },
+            {
+              "instruction": "G) PROVIDERS FIREBASE / COMPLEXES avec factory inject()",
+              "codeExample": "// AVANT (dans NgModule):\nproviders: [\n  provideFirebaseApp(() => initializeApp(environment.firebase)),\n  provideAppCheck(() => {\n    const injector = inject(Injector);\n    const options = injector.get(AppCheckOptionsService);\n    return initializeAppCheck(getApp(), options.getOptions());\n  })\n]\n\n// APRES (dans app.config.ts) - IDENTIQUE mais dans ApplicationConfig:\nexport const appConfig: ApplicationConfig = {\n  providers: [\n    provideFirebaseApp(() => initializeApp(environment.firebase)),\n    provideAppCheck(() => {\n      const injector = inject(Injector);\n      const options = injector.get(AppCheckOptionsService);\n      return initializeAppCheck(getApp(), options.getOptions());\n    }),\n    provideAuth(() => getAuth()),\n    provideFirestore(() => getFirestore())\n  ]\n};"
+            },
+            {
+              "instruction": "H) TOKENS CUSTOM (ENVIRONMENT, CONFIG, GIT_INFO)",
+              "codeExample": "// AVANT (dans NgModule):\nproviders: [\n  { provide: ENVIRONMENT, useValue: environment },\n  { provide: GIT_INFO, useValue: gitInfo }\n]\n\n// APRES (dans app.config.ts):\nimport { environment } from '../environments/environment';\nimport { gitInfo } from '../.git-info';\n\nexport const appConfig: ApplicationConfig = {\n  providers: [\n    { provide: ENVIRONMENT, useValue: environment },\n    { provide: GIT_INFO, useValue: gitInfo },\n    // ... autres providers\n  ]\n};"
+            }
+          ]
+        },
+        {
+          "number": 4,
+          "name": "IMPORTS OBLIGATOIRES",
+          "description": "S'assurer que chaque composant standalone a ses imports",
+          "actions": [
+            {
+              "instruction": "Chaque composant standalone doit importer explicitement ses dépendances",
+              "codeExample": "@Component({\n  standalone: true,\n  imports: [\n    CommonModule,        // ou: NgIf, NgFor, NgClass, AsyncPipe\n    FormsModule,         // si [(ngModel)]\n    ReactiveFormsModule, // si [formGroup]\n    RouterLink,          // si routerLink\n    RouterOutlet,        // si <router-outlet>\n    MyChildComponent,\n    MyPipe,\n    MyDirective\n  ]\n})"
+            },
+            {
+              "instruction": "Utiliser l'IDE/Language Service Angular pour détecter les imports manquants"
+            }
+          ]
+        },
+        {
+          "number": 5,
+          "name": "MISE A JOUR DES TESTS",
+          "description": "Adapter TestBed pour les composants standalone",
+          "actions": [
+            {
+              "instruction": "Déplacer les composants standalone de declarations vers imports",
+              "codeExample": "// AVANT:\nTestBed.configureTestingModule({\n  declarations: [MyComponent]\n})\n\n// APRES:\nTestBed.configureTestingModule({\n  imports: [MyComponent]\n})"
+            }
+          ]
+        },
+        {
+          "number": 6,
+          "name": "SERVICES",
+          "description": "Optimiser les services pour tree-shaking",
+          "actions": [
+            {
+              "instruction": "Préférer providedIn: 'root' pour les services singleton",
+              "codeExample": "@Injectable({ providedIn: 'root' })\nexport class MyService {}"
+            },
+            {
+              "instruction": "Pour les services feature-scoped, utiliser les providers de route"
+            }
+          ]
+        },
+        {
+          "number": 7,
+          "name": "SSR (SERVER-SIDE RENDERING)",
+          "description": "Migrer le bootstrap serveur si projet SSR/Universal",
+          "actions": [
+            {
+              "instruction": "Vérifier si le projet utilise SSR (présence de main.server.ts ou server.ts)",
+              "codeExample": "# Fichiers indicateurs SSR:\n- main.server.ts\n- server.ts\n- angular.json → \"server\" target\n- app.server.module.ts",
+              "codeLang": "bash"
+            },
+            {
+              "instruction": "SI PAS DE SSR → Skip ce stage",
+              "codeExample": "// Si aucun fichier serveur trouvé, passer directement à la validation"
+            },
+            {
+              "instruction": "Migrer main.server.ts vers standalone bootstrap",
+              "codeExample": "// AVANT (main.server.ts avec NgModule):\nimport { AppServerModule } from './app/app.server.module';\nexport { AppServerModule };\n\n// APRES (main.server.ts standalone):\nimport { bootstrapApplication } from '@angular/platform-browser';\nimport { AppComponent } from './app/app.component';\nimport { config } from './app/app.config.server';\n\nconst bootstrap = () => bootstrapApplication(AppComponent, config);\nexport default bootstrap;"
+            },
+            {
+              "instruction": "Créer app.config.server.ts avec les providers serveur",
+              "codeExample": "// app.config.server.ts\nimport { ApplicationConfig, mergeApplicationConfig } from '@angular/core';\nimport { provideServerRendering } from '@angular/platform-server';\nimport { appConfig } from './app.config';\n\nconst serverConfig: ApplicationConfig = {\n  providers: [\n    provideServerRendering()\n  ]\n};\n\nexport const config = mergeApplicationConfig(appConfig, serverConfig);"
+            },
+            {
+              "instruction": "Migrer CommonEngine si utilisé (Express server)",
+              "codeExample": "// AVANT (server.ts avec Module):\nnew CommonEngine().render({\n  bootstrap: AppServerModule,\n  ...\n})\n\n// APRES (server.ts avec standalone bootstrap):\nimport bootstrap from './main.server';\n\nnew CommonEngine().render({\n  bootstrap,\n  ...\n})"
+            },
+            {
+              "instruction": "Supprimer AppServerModule après migration",
+              "codeExample": "// Supprimer app.server.module.ts une fois la migration terminée\n// Vérifier que le build SSR fonctionne : npm run build:ssr && npm run serve:ssr"
+            }
+          ]
+        }
+      ],
+      "verificationCommands": [
+        "grep -r \"@NgModule\" --include=\"*.ts\" . | wc -l",
+        "ng build",
+        "npm test"
+      ]
+    }
   },
   {
     "key": "template_refs_no_this",
@@ -105,6 +286,7 @@
     },
     "category": "template",
     "isAutoFixable": true,
+    "minAngularVersion": 19,
     "migration_command": null,
     "risk_level": "medium",
     "code_description": "// Avant:\n<div #myDiv></div>\n{{ this.myDiv.textContent }}\n\n// Après:\n<div #myDiv></div>\n{{ myDiv.textContent }}",
@@ -121,7 +303,8 @@
     ],
     "regex": "BrowserModule\\.withServerTransition",
     "category": "imports",
-    "isAutoFixable": false,
+    "isAutoFixable": true,
+    "minAngularVersion": 19,
     "migration_command": null,
     "risk_level": "medium",
     "code_description": "// Avant:\nBrowserModule.withServerTransition({ appId: 'my-app' })\n\n// Après:\nimport { APP_ID } from '@angular/core';\nbootstrapApplication(App, {\n  providers: [{ provide: APP_ID, useValue: 'my-app' }]\n});",
@@ -179,6 +362,7 @@
     "regex": "\\bExperimentalPendingTasks\\b",
     "category": "api",
     "isAutoFixable": true,
+    "minAngularVersion": 19,
     "migration_command": null,
     "risk_level": "low",
     "code_description": "// Avant:\nimport { ExperimentalPendingTasks } from '@angular/core';\n\n// Après:\nimport { PendingTasks } from '@angular/core';",
@@ -203,7 +387,8 @@
     ],
     "regex": "router\\.errorHandler\\s*=",
     "category": "routing",
-    "isAutoFixable": false,
+    "isAutoFixable": true,
+    "minAngularVersion": 19,
     "migration_command": null,
     "risk_level": "medium",
     "code_description": "// Avant:\nthis.router.errorHandler = (error) => { };\n\n// Après:\nprovideRouter(routes,\n  withNavigationErrorHandler((error) => { })\n)",
@@ -232,7 +417,8 @@
     ],
     "regex": "implements\\s+Resolve<(?!.*RedirectCommand)",
     "category": "routing",
-    "isAutoFixable": false,
+    "isAutoFixable": true,
+    "minAngularVersion": 19,
     "migration_command": null,
     "risk_level": "medium",
     "code_description": "// Avant:\nResolve<User>\n\n// Après:\nResolve<User | RedirectCommand> {\n  return this.service.get().pipe(\n    catchError(() => of(new RedirectCommand('/error')))\n  );\n}",
@@ -260,7 +446,8 @@
     ],
     "regex": "triggerEffect|effect\\(\\s*\\(\\)",
     "category": "test",
-    "isAutoFixable": false,
+    "isAutoFixable": true,
+    "minAngularVersion": 19,
     "migration_command": null,
     "risk_level": "medium",
     "code_description": "// Avant:\ncomponent.triggerEffect();\nexpect(value).toBe('updated');\n\n// Après:\ncomponent.triggerEffect();\nawait fixture.whenStable();\nexpect(value).toBe('updated');",
@@ -295,7 +482,8 @@
     ],
     "regex": "fakeAsync\\s*\\(",
     "category": "test",
-    "isAutoFixable": false,
+    "isAutoFixable": true,
+    "minAngularVersion": 19,
     "migration_command": null,
     "risk_level": "low",
     "code_description": "// En v19: flush automatique des timers\n// Pour ancien comportement:\nfakeAsync(() => {\n  // ...\n}, { flush: false })",
@@ -326,7 +514,8 @@
     ],
     "regex": "createComponent\\s*\\(",
     "category": "api",
-    "isAutoFixable": false,
+    "isAutoFixable": true,
+    "minAngularVersion": 19,
     "migration_command": null,
     "risk_level": "low",
     "code_description": "// Pour éviter fallback par défaut:\ncreateComponent(MyComponent, {\n  projectableNodes: [[document.createTextNode('')]]\n});",

package/dist/src/data/rules/to19/rules-19-optionnelle.json

@@ -10,7 +10,8 @@
     ],
     "regex": "\\.get<.*>\\s*\\(",
     "category": "reactive",
-    "isAutoFixable": false,
+    "isAutoFixable": true,
+    "minAngularVersion": 19,
     "migration_command": null,
     "risk_level": "medium",
     "code_description": "// Avant (HttpClient GET):\nusers$ = this.http.get<User[]>('/api/users').pipe(\n  catchError(() => of([])),\n  shareReplay(1)\n);\n\n// Template\n<div *ngIf=\"users$ | async as users\">\n  <user-list [users]=\"users\"/>\n</div>\n\n// Après (httpResource - Angular 19.2+):\nimport { httpResource } from '@angular/core';\n\nusersResource = httpResource({\n  url: '/api/users',\n  loader: () => fetch('/api/users').then(r => r.json())\n});\n\n// Template avec signal\n@switch (usersResource.status()) {\n  @case('loading') { <spinner/> }\n  @case('resolved') { <user-list [users]=\"usersResource.value()\"/> }\n  @case('error') { <error-message/> }\n}\n\n// ⚠️ Uniquement pour GET (fetching data)\n// Pour POST/PUT/DELETE, garder HttpClient classique",
@@ -55,7 +56,8 @@
     ],
     "regex": "(?<![\"\\'])\\bprovideClientHydration\\s*\\(",
     "category": "ssr",
-    "isAutoFixable": false,
+    "isAutoFixable": true,
+    "minAngularVersion": 19,
     "migration_command": null,
     "risk_level": "high",
     "code_description": "bootstrapApplication(App, {\n  providers: [\n    provideClientHydration(withIncrementalHydration())\n  ]\n});\n\n// Template:\n@defer (render on server; hydrate on interaction) {\n  <heavy-component />\n}",
@@ -83,7 +85,8 @@
     ],
     "regex": "^(?![\\s\\S]*(\"applicationMaxAge\"|\"refreshAhead\"))",
     "category": "pwa",
-    "isAutoFixable": false,
+    "isAutoFixable": true,
+    "minAngularVersion": 19,
     "migration_command": null,
     "risk_level": "low",
     "code_description": "// ngsw-config.json\n{\n  \"applicationMaxAge\": \"7d\",\n  \"dataGroups\": [{\n    \"cacheConfig\": {\n      \"maxAge\": \"1h\",\n      \"refreshAhead\": \"10m\"\n    }\n  }]\n}",
@@ -100,7 +103,8 @@
     ],
     "regex": "export\\s+const\\s+routes\\s*:\\s*Routes",
     "category": "ssr",
-    "isAutoFixable": false,
+    "isAutoFixable": true,
+    "minAngularVersion": 19,
     "migration_command": null,
     "risk_level": "medium",
     "code_description": "// app.routes.server.ts\nimport { RenderMode } from '@angular/ssr';\n\nexport const serverRoutes = [\n  { path: '', renderMode: RenderMode.Prerender },\n  { path: 'blog/**', renderMode: RenderMode.Server },\n  { path: 'admin/**', renderMode: RenderMode.Client }\n];",
@@ -151,7 +155,8 @@
     ],
     "regex": "\\bcomponent\\s*:\\s*[A-Z]\\w+Component\\b",
     "category": "routing",
-    "isAutoFixable": false,
+    "isAutoFixable": true,
+    "minAngularVersion": 19,
     "migration_command": "npx ng generate @angular/core:route-lazy-loading --path=./",
     "nxMigrationCommand": "npx nx generate @angular/core:route-lazy-loading --path=./",
     "risk_level": "low",
@@ -195,7 +200,8 @@
     ],
     "regex": "constructor\\s*\\([^)]*private\\s+\\w+\\s*:\\s*\\w+",
     "category": "di",
-    "isAutoFixable": false,
+    "isAutoFixable": true,
+    "minAngularVersion": 19,
     "migration_command": "npx ng generate @angular/core:inject-migration --path=./",
     "nxMigrationCommand": "npx nx generate @angular/core:inject-migration --path=./",
     "risk_level": "low",

package/dist/src/data/rules/to19/rules-19-recommande.json

@@ -11,6 +11,7 @@
     "regex": "@Input\\s*\\([^)]*\\)\\s*(?!set\\s|get\\s)\\w+\\s*[:\\=]",
     "category": "signals",
     "isAutoFixable": true,
+    "minAngularVersion": 19,
     "migration_command": "npx ng generate @angular/core:signal-input-migration --path=./ --best-effort-mode=false",
     "nxMigrationCommand": "npx nx generate @angular/core:signal-input-migration --path=./ --best-effort-mode=false",
     "risk_level": "medium",
@@ -39,7 +40,8 @@
     ],
     "regex": "@Input\\s*\\([^)]*\\)\\s*(get|set)\\s+\\w+",
     "category": "signals",
-    "isAutoFixable": false,
+    "isAutoFixable": true,
+    "minAngularVersion": 19,
     "migration_command": null,
     "risk_level": "high",
     "code_description": "// Avant (setter @Input - NON migré automatiquement):\n@Input() set selectedItem(value: Item) {\n  this._selectedItem = value;\n  this.processItem(value);\n}\n\n// Après (migration manuelle vers signal + computed):\nselectedItem = input<Item>();\nprivate processedItem = computed(() => {\n  const item = this.selectedItem();\n  return this.processItem(item);\n});",
@@ -67,7 +69,8 @@
     ],
     "regex": "@Output\\s*\\(\\)",
     "category": "signals",
-    "isAutoFixable": false,
+    "isAutoFixable": true,
+    "minAngularVersion": 19,
     "migration_command": "npx ng generate @angular/core:output-migration --path=./",
     "nxMigrationCommand": "npx nx generate @angular/core:output-migration --path=./",
     "risk_level": "low",
@@ -100,7 +103,8 @@
     ],
     "regex": "@(ViewChild|ViewChildren|ContentChild|ContentChildren)\\s*\\(",
     "category": "signals",
-    "isAutoFixable": false,
+    "isAutoFixable": true,
+    "minAngularVersion": 19,
     "migration_command": "npx ng generate @angular/core:signal-queries-migration --path=./ --best-effort-mode=false",
     "nxMigrationCommand": "npx nx generate @angular/core:signal-queries-migration --path=./ --best-effort-mode=false",
     "risk_level": "medium",
@@ -135,7 +139,8 @@
     ],
     "regex": "effect\\s*\\(\\s*\\(\\)\\s*=>\\s*\\{[^}]*\\.set\\(",
     "category": "signals",
-    "isAutoFixable": false,
+    "isAutoFixable": true,
+    "minAngularVersion": 19,
     "migration_command": null,
     "risk_level": "low",
     "code_description": "// Avant:\nngOnInit() {\n  effect(() => {\n    if (this.category() !== 'all') {\n      this.itemsPerPage.set(10);\n    }\n  });\n}\n\n// Après:\nitemsPerPage = linkedSignal({\n  source: this.category,\n  computation: () => 10\n});",
@@ -177,7 +182,8 @@
     ],
     "regex": "provide:\\s*APP_INITIALIZER",
     "category": "architecture",
-    "isAutoFixable": false,
+    "isAutoFixable": true,
+    "minAngularVersion": 19,
     "migration_command": null,
     "risk_level": "low",
     "code_description": "// Avant:\n{ provide: APP_INITIALIZER, useFactory: ... }\n\n// Après:\nprovideAppInitializer(() => {\n  return inject(ConfigService).load();\n})",

package/dist/src/data/rules/to20/rules-20-obligatoire.json

@@ -5,14 +5,15 @@
     "description": "Angular 20 requiert Node.js 22.12.0 ou supérieur et TypeScript 5.8+. Cette version active par défaut le build ESM, introduit le support expérimental de Vitest, et adopte un nouveau guide de style sans suffixes. Les versions de Node 22.0 à 22.10 causent des instabilités.",
     "estimated_time_per_occurrence": 25,
     "onFile": "package.json",
+    "routineType": "environment-migration",
     "fileTypes": ["package.json"],
     "regex": "\"@angular/(core|cli)\"\\s*:\\s*\"(?:(?:\\^|~)?1[0-9](?:\\.\\d+){0,2})\"",
     "category": "environment",
-    "isAutoFixable": false,
+    "isAutoFixable": true,
     "migration_command": "npx ng update @angular/core@20 @angular/cli@20",
-    "nxMigrationCommand": "npx nx migrate @angular/core@20 @angular/cli@20 && npx nx migrate --run-migrations",
+    "nxMigrationCommand": "npx nx migrate nx@21.6.10 && npm install && npm install typescript@~5.8.3 && npx nx migrate --run-migrations",
     "risk_level": "critical",
-    "code_description": "// Migration Angular 20\n// Node : >= 22.12.0 (éviter 22.0 → 22.10)\n// TypeScript : ~5.8.0\n// Commande Angular CLI :\n//   npx ng update @angular/core@20 @angular/cli@20\n// Commande Nx :\n//   npx nx migrate @angular/core@20 @angular/cli@20 && npx nx migrate --run-migrations",
+    "code_description": "// Migration Angular 19 → 20 (Nx)\n// 1. npx nx migrate nx@21.6.10\n// 2. Mettre à jour deps tierces Angular dans package.json vers @20 + !!! Bonne version de typescript si non spécifié !!!\n// 3. npm install && npm install typescript@~5.8.3\n// 4. npx nx migrate --run-migrations",
     "doc_url": "https://angular.dev/reference/migrations"
   },
   {
@@ -44,6 +45,7 @@
     "regex": "^(?![\\s\\S]*\"typescript\"[\\s\\S]*\"[<>=~^]*(?:5\\.[8-9]|[6-9]\\d*)\\.)[\\s\\S]+",
     "category": "environment",
     "isAutoFixable": true,
+    "minAngularVersion": 19,
     "migration_command": "npm install typescript@~5.8.0",
     "risk_level": "medium",
     "code_description": "// package.json\n// Avant: \"typescript\": \"~5.5.0\"\n// Après: \"typescript\": \"~5.8.0\"",
@@ -61,6 +63,7 @@
     "regex": "\\bafterRender\\s*\\(",
     "category": "api",
     "isAutoFixable": true,
+    "minAngularVersion": 19,
     "migration_command": null,
     "risk_level": "low",
     "code_description": "// Avant:\nafterRender(() => { });\n\n// Après:\nafterEveryRender(() => { });",
@@ -86,6 +89,7 @@
     "regex": "provideExperimentalCheckNoChangesForDebug",
     "category": "api",
     "isAutoFixable": true,
+    "minAngularVersion": 19,
     "migration_command": null,
     "risk_level": "low",
     "code_description": "// Avant:\nprovideExperimentalCheckNoChangesForDebug()\n\n// Après:\nprovideCheckNoChangesConfig()\n// Note: useNgZoneOnStable supprimé",
@@ -111,6 +115,7 @@
     "regex": "\\bprovideExperimentalZonelessChangeDetection\\s*\\(",
     "category": "api",
     "isAutoFixable": true,
+    "minAngularVersion": 19,
     "migration_command": null,
     "risk_level": "medium",
     "code_description": "// Avant:\nprovideExperimentalZonelessChangeDetection()\n\n// Après:\nprovideZonelessChangeDetection()",
@@ -136,6 +141,7 @@
     "regex": "\\bresource\\s*\\(\\s*\\{[^}]*request\\s*:",
     "category": "api",
     "isAutoFixable": true,
+    "minAngularVersion": 19,
     "migration_command": null,
     "risk_level": "medium",
     "code_description": "// Avant:\nresource({\n  request: () => ({ id: userId() }),\n  loader: ({ request }) => fetch(`/users/${request.id}`)\n})\n\n// Après:\nresource({\n  params: () => ({ id: userId() }),\n  loader: ({ request }) => fetch(`/users/${request.id}`)\n})",
@@ -168,6 +174,7 @@
     "regex": "\\brxResource[\\s\\S]*?loader\\s*:",
     "category": "api",
     "isAutoFixable": true,
+    "minAngularVersion": 19,
     "migration_command": null,
     "risk_level": "medium",
     "code_description": "// Avant:\nrxResource({\n  loader: () => httpClient.get('/data')\n})\n\n// Après:\nrxResource({\n  stream: () => httpClient.get('/data')\n})",
@@ -200,6 +207,7 @@
     "regex": "ResourceStatus\\.(Loading|Idle|Resolved|Error|Reloading|Local)",
     "category": "api",
     "isAutoFixable": true,
+    "minAngularVersion": 19,
     "migration_command": null,
     "risk_level": "medium",
     "code_description": "// Avant:\nimport { ResourceStatus } from '@angular/core';\nif (resource.status() === ResourceStatus.Loading) { }\n\n// Après:\nif (resource.status() === 'loading') { }\n// Valeurs: 'idle' | 'loading' | 'resolved' | 'error' | 'reloading' | 'local'",
@@ -262,6 +270,7 @@
     "regex": "TestBed\\.flushEffects\\s*\\(",
     "category": "test",
     "isAutoFixable": true,
+    "minAngularVersion": 19,
     "migration_command": null,
     "risk_level": "medium",
     "code_description": "// Avant:\nTestBed.flushEffects();\n\n// Après:\nTestBed.tick();",
@@ -427,6 +436,7 @@
     "regex": "TestBed\\.get\\s*\\(",
     "category": "test",
     "isAutoFixable": true,
+    "minAngularVersion": 19,
     "migration_command": null,
     "risk_level": "medium",
     "code_description": "// Avant:\nconst service = TestBed.get(MyService);\n\n// Après:\nconst service = TestBed.inject(MyService);",
@@ -456,6 +466,7 @@
     "regex": "InjectFlags\\.(Optional|Self|SkipSelf|Host)",
     "category": "api",
     "isAutoFixable": true,
+    "minAngularVersion": 19,
     "migration_command": null,
     "risk_level": "medium",
     "code_description": "// Avant:\nimport { InjectFlags } from '@angular/core';\ninject(MyService, InjectFlags.Optional);\n\n// Après:\ninject(MyService, { optional: true });",
@@ -552,6 +563,7 @@
     "regex": "\"builder\"[\\s\\S]*?\"@angular/localize\"[\\s\\S]*?\"options\"[\\s\\S]*?\\{[\\s\\S]*?\"name\"[\\s\\S]*?\"[^\"]+\"",
     "category": "config",
     "isAutoFixable": true,
+    "minAngularVersion": 19,
     "migration_command": null,
     "risk_level": "low",
     "code_description": "// angular.json\n// Avant:\n\"options\": { \"name\": \"my-project\" }\n\n// Après:\n\"options\": { \"project\": \"my-project\" }",

package/dist/src/data/rules/to20/rules-20-optionnelle.json

@@ -115,12 +115,12 @@
     "fileTypes": [
       "angular.json"
     ],
-    "regex": "^(?![\\s\\S]*\"schematics\"[\\s\\S]*\"@schematics/angular:component\"[\\s\\S]*\"type\"[\\s\\S]*\"component\")[\\s\\S]+",
+    "regex": "^(?![\\s\\S]*\"(?:schematics|generators)\"[\\s\\S]*\"@(?:schematics|nx)/angular:component\"[\\s\\S]*\"type\"[\\s\\S]*\"component\")[\\s\\S]+",
     "category": "style",
     "isAutoFixable": false,
     "migration_command": null,
     "risk_level": "low",
-    "code_description": "// Par défaut en v20: ng generate component user crée user.ts (sans suffixe)\n// Détecte si config pour GARDER suffixes N'EST PAS présente\n\n// MATCH (routine pertinente - config manquante):\n{\n  \"projects\": { ... }\n  // pas de config schematics pour type: \"component\"\n}\n\n// NO MATCH (déjà configuré - garde les suffixes):\n// angular.json ou nx.json:\n{\n  \"schematics\": {\n    \"@schematics/angular:component\": { \"type\": \"component\" }\n  }\n}",
+    "code_description": "// Par défaut en v20: ng generate component user crée user.ts (sans suffixe)\n// Détecte si config pour GARDER suffixes N'EST PAS présente\n\n// MATCH (routine pertinente - config manquante):\n{\n  \"projects\": { ... }\n  // pas de config schematics/generators pour type: \"component\"\n}\n\n// NO MATCH (déjà configuré - garde les suffixes):\n// angular.json:\n{\n  \"schematics\": {\n    \"@schematics/angular:component\": { \"type\": \"component\" }\n  }\n}\n// nx.json:\n{\n  \"generators\": {\n    \"@nx/angular:component\": { \"type\": \"component\" }\n  }\n}",
     "doc_url": "https://angular.dev/reference/migrations"
   },
   {

package/dist/src/data/rules/to20/rules-20-recommande.json

@@ -12,6 +12,7 @@
     "regex": "\\*ng(If|For|Switch)",
     "category": "template",
     "isAutoFixable": true,
+    "minAngularVersion": 17,
     "migration_command": "npx ng generate @angular/core:control-flow --path=./ --format=true",
     "nxMigrationCommand": "npx nx generate @angular/core:control-flow --path=./ --format=true",
     "risk_level": "high",
@@ -146,6 +147,7 @@
     "regex": "appConfig",
     "category": "architecture",
     "isAutoFixable": true,
+    "minAngularVersion": 19,
     "migration_command": null,
     "risk_level": "medium",
     "code_description": "// app.config.ts - Configuration zoneless complete:\nimport { ApplicationConfig, provideZonelessChangeDetection, provideBrowserGlobalErrorListeners } from '@angular/core';\n\nexport const appConfig: ApplicationConfig = {\n  providers: [\n    provideZonelessChangeDetection(),\n    provideBrowserGlobalErrorListeners()\n  ]\n};",