@silvestv/migration-planificator 3.0.0

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

@@ -0,0 +1,223 @@
+[
+  {
+    "key": "resource_api_http",
+    "summary": "Utiliser resource API pour gestion HTTP réactive",
+    "description": "L'API resource simplifie la gestion d'état des requêtes HTTP avec status tracking automatique (loading, resolved, error), retry intégré et invalidation réactive. Alternative moderne aux patterns Observable + AsyncPipe, particulièrement utile avec les signaux.",
+    "estimated_time_per_occurrence": 15,
+    "onFile": null,
+    "fileTypes": [
+      "*.ts"
+    ],
+    "regex": "\\.(get|post|put|delete|patch)<.*>\\s*\\(",
+    "category": "reactive",
+    "auto_fixable": false,
+    "migration_command": null,
+    "risk_level": "medium",
+    "code_description": "import { resource } from '@angular/core';\n\nuserResource = resource({\n  loader: () => fetch('/api/user').then(r => r.json())\n});\n\n// Template:\n@switch (userResource.status()) {\n  @case ('loading') { <p>Chargement...</p> }\n  @case ('resolved') { <p>{{ userResource.value() }}</p> }\n}",
+    "astPattern": {
+      "nodeType": "CallExpression",
+      "expression": {
+        "nodeType": "PropertyAccessExpression",
+        "expression": {
+          "name": [
+            "httpClient",
+            "http",
+            "this.httpClient",
+            "this.http"
+          ]
+        },
+        "name": [
+          "get",
+          "post",
+          "put",
+          "delete",
+          "patch"
+        ]
+      },
+      "parent": {
+        "notNodeType": "CallExpression",
+        "notFunctionName": "resource"
+      },
+      "excludeContext": [
+        "StringLiteral",
+        "Comment"
+      ]
+    },
+    "doc_url": "https://angular.dev/reference/migrations"
+  },
+  {
+    "key": "incremental_hydration",
+    "summary": "Hydratation incrémentale expérimentale",
+    "description": "L'hydratation incrémentale permet d'hydrater progressivement l'application Angular côté client, en priorisant les parties visibles et interactives. Combine @defer avec hydrate triggers (viewport, interaction, idle) pour optimiser TTI et réduire le JavaScript initial.",
+    "estimated_time_per_occurrence": 20,
+    "onFile": null,
+    "fileTypes": [
+      "*.ts",
+      "*.html"
+    ],
+    "regex": "(?<![\"\\'])\\bprovideClientHydration\\s*\\(",
+    "category": "ssr",
+    "auto_fixable": false,
+    "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}",
+    "astPattern": {
+      "nodeType": "CallExpression",
+      "functionName": "provideClientHydration",
+      "arguments": {
+        "missing": "withIncrementalHydration"
+      },
+      "excludeContext": [
+        "StringLiteral",
+        "Comment"
+      ]
+    },
+    "doc_url": "https://angular.dev/reference/migrations"
+  },
+  {
+    "key": "service_worker_enhanced",
+    "summary": "Service Worker avec refreshAhead et applicationMaxAge",
+    "description": "Angular 19 ajoute refreshAhead pour pré-charger les assets avant expiration du cache et applicationMaxAge pour définir la durée de vie globale de l'app dans le cache. Améliore l'expérience offline et réduit les latences perçues.",
+    "estimated_time_per_occurrence": 10,
+    "onFile": "ngsw-config.json",
+    "fileTypes": [
+      "ngsw-config.json"
+    ],
+    "regex": "^(?![\\s\\S]*(\"applicationMaxAge\"|\"refreshAhead\"))",
+    "category": "pwa",
+    "auto_fixable": false,
+    "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}",
+    "doc_url": "https://angular.dev/reference/migrations"
+  },
+  {
+    "key": "hybrid_rendering",
+    "summary": "Rendu hybride par route (SSR/SSG/CSR)",
+    "description": "Le rendu hybride permet de définir une stratégie de rendu différente par route: Prerender pour les pages statiques, Server pour le contenu dynamique, Client pour les parties authentifiées. getPrerenderParams génère les paramètres pour le SSG dynamique.",
+    "estimated_time_per_occurrence": 30,
+    "onFile": null,
+    "fileTypes": [
+      "*.ts"
+    ],
+    "regex": "export\\s+const\\s+routes\\s*:\\s*Routes",
+    "category": "ssr",
+    "auto_fixable": false,
+    "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];",
+    "astPattern": {
+      "nodeType": "VariableStatement",
+      "modifiers": [
+        "export"
+      ],
+      "declarations": {
+        "name": [
+          "routes",
+          "serverRoutes"
+        ],
+        "initializer": {
+          "nodeType": "ArrayLiteralExpression",
+          "elements": {
+            "nodeType": "ObjectLiteralExpression",
+            "properties": {
+              "path": {
+                "exists": true
+              },
+              "renderMode": {
+                "missing": true
+              }
+            }
+          }
+        }
+      },
+      "excludeContext": [
+        "StringLiteral",
+        "Comment"
+      ]
+    },
+    "doc_url": "https://angular.dev/reference/migrations"
+  },
+  {
+    "key": "route_lazy_loading",
+    "summary": "Migration automatique vers lazy loading",
+    "description": "Le schematic route-lazy-loading convertit automatiquement les routes avec component eager loading en loadComponent avec imports dynamiques, réduisant le bundle initial. Analyse le code pour identifier les opportunités de lazy loading et applique les transformations.",
+    "estimated_time_per_occurrence": 5,
+    "onFile": null,
+    "fileTypes": [
+      "*.routes.ts",
+      "*.routing.ts",
+      "*-routing.module.ts",
+      "app-routing.ts",
+      "app.routes.ts"
+    ],
+    "regex": "\\bcomponent\\s*:\\s*[A-Z]\\w+Component\\b",
+    "category": "routing",
+    "auto_fixable": false,
+    "migration_command": "ng generate @angular/core:route-lazy-loading",
+    "risk_level": "low",
+    "code_description": "// Avant:\n{ path: 'users', component: UsersComponent }\n\n// Après:\n{\n  path: 'users',\n  loadComponent: () => import('./users.component').then(m => m.UsersComponent)\n}",
+    "astPattern": {
+      "nodeType": "ObjectLiteralExpression",
+      "properties": {
+        "path": {
+          "exists": true
+        },
+        "component": {
+          "exists": true
+        },
+        "loadComponent": {
+          "missing": true
+        }
+      },
+      "parent": {
+        "nodeType": [
+          "VariableDeclaration",
+          "VariableStatement"
+        ],
+        "name": [
+          "routes",
+          "serverRoutes",
+          "appRoutes"
+        ]
+      },
+      "excludeContext": [
+        "StringLiteral",
+        "Comment"
+      ]
+    },
+    "doc_url": "https://angular.dev/reference/migrations"
+  },
+  {
+    "key": "inject_function_migration",
+    "summary": "Migration constructor → inject()",
+    "description": "La fonction inject() moderne remplace l'injection par constructeur avec une syntaxie plus concise et fonctionnelle. Permet l'injection dans les propriétés de classe, élimine le besoin de déclarer les dépendances deux fois (paramètres + propriétés) et facilite le tree-shaking.",
+    "estimated_time_per_occurrence": 5,
+    "onFile": null,
+    "fileTypes": [
+      "*.ts"
+    ],
+    "regex": "constructor\\s*\\([^)]*private\\s+\\w+\\s*:\\s*\\w+",
+    "category": "di",
+    "auto_fixable": false,
+    "migration_command": "ng generate @angular/core:inject",
+    "risk_level": "low",
+    "code_description": "// Avant:\nconstructor(private http: HttpClient) {}\n\n// Après:\nprivate http = inject(HttpClient);",
+    "astPattern": {
+      "nodeType": "Constructor",
+      "parameters": {
+        "hasModifier": [
+          "private",
+          "public",
+          "protected"
+        ],
+        "hasType": true
+      },
+      "excludeContext": [
+        "StringLiteral",
+        "Comment"
+      ]
+    },
+    "doc_url": "https://angular.dev/reference/migrations"
+  }
+]

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

@@ -0,0 +1,200 @@
+[
+  {
+    "key": "signal_input_migration",
+    "summary": "Migration @Input → input()",
+    "description": "Migrer les décorateurs @Input vers la nouvelle API input() basée sur les signaux pour bénéficier d'une réactivité fine-grained et d'un meilleur tree-shaking. La migration automatique via schematic gère la plupart des cas, nécessite une revue manuelle pour les inputs complexes.",
+    "estimated_time_per_occurrence": 3,
+    "onFile": null,
+    "fileTypes": [
+      "*.ts"
+    ],
+    "regex": "@Input\\s*\\(\\)",
+    "category": "signals",
+    "auto_fixable": false,
+    "migration_command": "ng generate @angular/core:signal-input-migration",
+    "risk_level": "medium",
+    "code_description": "// Avant:\n@Input() name: string;\n@Input({ required: true }) age: number;\n\n// Après:\nreadonly name = input<string>();\nreadonly age = input.required<number>();",
+    "astPattern": {
+      "nodeType": "Decorator",
+      "name": "Input",
+      "parent": {
+        "nodeType": "PropertyDeclaration"
+      },
+      "excludeContext": [
+        "StringLiteral",
+        "Comment"
+      ]
+    },
+    "doc_url": "https://angular.dev/reference/migrations"
+  },
+  {
+    "key": "signal_output_migration",
+    "summary": "Migration @Output → output()",
+    "description": "Remplacer @Output et EventEmitter par la nouvelle fonction output() qui retourne un OutputEmitterRef typé et interopérable avec les signaux. Plus performant et offre une meilleure intégration avec l'écosystème signals.",
+    "estimated_time_per_occurrence": 3,
+    "onFile": null,
+    "fileTypes": [
+      "*.ts"
+    ],
+    "regex": "@Output\\s*\\(\\)",
+    "category": "signals",
+    "auto_fixable": false,
+    "migration_command": "ng generate @angular/core:output-migration",
+    "risk_level": "low",
+    "code_description": "// Avant:\n@Output() userChange = new EventEmitter<User>();\n\n// Après:\nreadonly userChange = output<User>();",
+    "astPattern": {
+      "nodeType": "Decorator",
+      "name": "Output",
+      "parent": {
+        "nodeType": "PropertyDeclaration",
+        "initializer": {
+          "nodeType": "NewExpression",
+          "expression": "EventEmitter"
+        }
+      },
+      "excludeContext": [
+        "StringLiteral",
+        "Comment"
+      ]
+    },
+    "doc_url": "https://angular.dev/reference/migrations"
+  },
+  {
+    "key": "signal_queries_migration",
+    "summary": "Migration @ViewChild/@ContentChild → viewChild()/contentChild()",
+    "description": "Migrer les query decorators vers les fonctions signal-based viewChild, viewChildren, contentChild et contentChildren. Ces nouvelles APIs retournent des signaux qui se mettent à jour automatiquement quand la vue change, éliminant le besoin de ngAfterViewInit dans beaucoup de cas.",
+    "estimated_time_per_occurrence": 3,
+    "onFile": null,
+    "fileTypes": [
+      "*.ts"
+    ],
+    "regex": "@(ViewChild|ViewChildren|ContentChild|ContentChildren)\\s*\\(",
+    "category": "signals",
+    "auto_fixable": false,
+    "migration_command": "ng generate @angular/core:signal-queries-migration",
+    "risk_level": "medium",
+    "code_description": "// Avant:\n@ViewChild('ref') ref: ElementRef;\n\n// Après:\nreadonly ref = viewChild<ElementRef>('ref');",
+    "astPattern": {
+      "nodeType": "Decorator",
+      "name": [
+        "ViewChild",
+        "ViewChildren",
+        "ContentChild",
+        "ContentChildren"
+      ],
+      "parent": {
+        "nodeType": "PropertyDeclaration"
+      },
+      "excludeContext": [
+        "StringLiteral",
+        "Comment"
+      ]
+    },
+    "doc_url": "https://angular.dev/reference/migrations"
+  },
+  {
+    "key": "linkedSignal_state",
+    "summary": "Utiliser linkedSignal pour état dépendant",
+    "description": "linkedSignal remplace les patterns effect + set pour gérer l'état dérivé avec reset automatique. Quand le signal source change, le signal lié est automatiquement recalculé avec la fonction computation, éliminant la logique manuelle dans effects.",
+    "estimated_time_per_occurrence": 10,
+    "onFile": null,
+    "fileTypes": [
+      "*.ts",
+      "*.spec.ts"
+    ],
+    "regex": "effect\\s*\\(\\s*\\(\\)\\s*=>\\s*\\{[^}]*\\.set\\(",
+    "category": "signals",
+    "auto_fixable": false,
+    "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});",
+    "astPattern": {
+      "nodeType": "CallExpression",
+      "functionName": "effect",
+      "arguments": {
+        "contains": {
+          "nodeType": "ArrowFunction",
+          "body": {
+            "contains": {
+              "nodeType": "CallExpression",
+              "expression": {
+                "nodeType": "PropertyAccessExpression",
+                "propertyName": [
+                  "set",
+                  "update"
+                ]
+              }
+            }
+          }
+        }
+      },
+      "excludeContext": [
+        "StringLiteral",
+        "Comment"
+      ]
+    },
+    "doc_url": "https://angular.dev/reference/migrations"
+  },
+  {
+    "key": "provideAppInitializer",
+    "summary": "Utiliser provideAppInitializer au lieu de APP_INITIALIZER",
+    "description": "La fonction provideAppInitializer offre une API plus simple et plus typée que le token APP_INITIALIZER multi-provider. Elle supporte automatiquement inject() et élimine le besoin de deps array, simplifiant la configuration d'initialisation.",
+    "estimated_time_per_occurrence": 5,
+    "onFile": null,
+    "fileTypes": [
+      "*.ts"
+    ],
+    "regex": "provide:\\s*APP_INITIALIZER",
+    "category": "architecture",
+    "auto_fixable": false,
+    "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})",
+    "astPattern": {
+      "nodeType": "PropertyAssignment",
+      "name": "provide",
+      "initializer": {
+        "nodeType": "Identifier",
+        "name": "APP_INITIALIZER"
+      },
+      "parent": {
+        "nodeType": "ObjectLiteralExpression",
+        "properties": {
+          "useFactory": {
+            "exists": true
+          }
+        }
+      },
+      "excludeContext": [
+        "StringLiteral",
+        "Comment"
+      ]
+    },
+    "doc_url": "https://angular.dev/reference/migrations"
+  },
+  {
+    "key": "routerOutletData",
+    "summary": "Partager données via routerOutletData",
+    "description": "routerOutletData permet de passer des données réactives du composant parent aux composants routés via le router-outlet, évitant le prop drilling ou l'utilisation de services partagés. Les données sont accessibles via le token ROUTER_OUTLET_DATA dans les composants enfants.",
+    "estimated_time_per_occurrence": 10,
+    "onFile": null,
+    "fileTypes": [
+      "*.html"
+    ],
+    "regex": "<router-outlet[^>]*>",
+    "category": "routing",
+    "auto_fixable": false,
+    "migration_command": null,
+    "risk_level": "low",
+    "code_description": "// Parent:\n<router-outlet [routerOutletData]=\"sharedData\"></router-outlet>\n\n// Enfant:\ndata = inject(ROUTER_OUTLET_DATA);",
+    "astPattern": {
+      "nodeType": "Decorator",
+      "name": "Component",
+      "template": {
+        "contains": "router-outlet",
+        "notContains": "routerOutletData"
+      }
+    },
+    "doc_url": "https://angular.dev/reference/migrations"
+  }
+]