docs: add update guide for v17

Author: mgechev

src/app/app.component.ts

@@ -35,6 +35,7 @@ export class AppComponent {
   afterRecommendations: Step[] = [];
 
   versions = [
+    { name: '18.0', number: 1800 },
     { name: '17.0', number: 1700 },
     { name: '16.0', number: 1600 },
     { name: '15.0', number: 1500 },
@@ -71,7 +72,7 @@ export class AppComponent {
   ];
   from = this.versions.find((version) => version.name === '15.0');
   to = this.versions.find((version) => version.name === '16.0');
-  futureVersion = 1700
+  futureVersion = 1800
   /**
    * Only save the locale in the URL if it was already there, or the user changed it
    */

src/app/recommendations.ts

@@ -251,6 +251,7 @@ export const RECOMMENDATIONS: Step[] = [
 
   { possibleIn: 1600, necessaryAsOf: 1600, level: ApplicationComplexity.Basic, step: 'v16 node support', action: 'Make sure that you are using a supported version of node.js before you upgrade your application. Angular v16 supports node.js versions: v16 and v18.' },
   { possibleIn: 1600, necessaryAsOf: 1600, level: ApplicationComplexity.Basic, step: 'v16 ts support', action: 'Make sure that you are using a supported version of TypeScript before you upgrade your application. Angular v16 supports TypeScript version 4.9.3 or later.' },
+  { possibleIn: 1500, necessaryAsOf: 1500, level: ApplicationComplexity.Basic, step: 'v16 ng update', action: 'In the application\'s project directory, run `ng update @angular/core@16 @angular/cli@16` to update your application to Angular v16.' },
   { possibleIn: 1600, necessaryAsOf: 1600, level: ApplicationComplexity.Basic, step: 'v16 zone.js support', action: 'Make sure that you are using a supported version of Zone.js before you upgrade your application. Angular v16 supports Zone.js version 0.13.x or later.' },
   { possibleIn: 1600, necessaryAsOf: 1600, level: ApplicationComplexity.Advanced, step: 'v16 RouterEvent', action: 'The Event union no longer contains `RouterEvent`, which means that if you\'re using the Event type you may have to change the type definition from `(e: Event)` to `(e: Event|RouterEvent)`'},
   { possibleIn: 1600, necessaryAsOf: 1600, level: ApplicationComplexity.Advanced, step: 'v16 routerEvent prop type', action: 'In addition to `NavigationEnd` the `routerEvent` property now also accepts type `NavigationSkipped`'},
@@ -278,4 +279,21 @@ export const RECOMMENDATIONS: Step[] = [
   { possibleIn: 1600, necessaryAsOf: 1600, level: ApplicationComplexity.Medium, step: 'v16 BrowserTransferStateModule', action: '`BrowserTransferStateModule` is no longer available and any reference to it can be removed from your applications.'},
   { possibleIn: 1600, necessaryAsOf: 1600, level: ApplicationComplexity.Medium, step: 'v16 ReflectiveInjector', action: 'Update your code to use `Injector.create` rather than `ReflectiveInjector` since `ReflectiveInjector` is removed.'},
   { possibleIn: 1600, necessaryAsOf: 1600, level: ApplicationComplexity.Basic, step: 'v16 QueryList', action: '`QueryList.filter` now supports type guard functions. Since the type will be narrowed, you may have to update your application code that relies on the old behavior.'},
+
+  { possibleIn: 1700, necessaryAsOf: 1700, level: ApplicationComplexity.Basic, step: 'v17 node support', action: 'Make sure that you are using a supported version of node.js before you upgrade your application. Angular v17 supports node.js versions: v18.13.0 and newer' },
+  { possibleIn: 1700, necessaryAsOf: 1700, level: ApplicationComplexity.Basic, step: 'v17 ts support', action: 'Make sure that you are using a supported version of TypeScript before you upgrade your application. Angular v17 supports TypeScript version 5.2 or later.' },
+  { possibleIn: 1700, necessaryAsOf: 1700, level: ApplicationComplexity.Basic, step: 'v17 zone.js support', action: 'Make sure that you are using a supported version of Zone.js before you upgrade your application. Angular v16 supports Zone.js version 0.14.x or later.' },
+  { possibleIn: 1500, necessaryAsOf: 1500, level: ApplicationComplexity.Basic, step: 'v17 ng update', action: 'In the application\'s project directory, run `ng update @angular/core@17 @angular/cli@17` to update your application to Angular v17.' },
+  { possibleIn: 1700, necessaryAsOf: 1700, level: ApplicationComplexity.Medium, step: 'v17 style removal', action: 'Angular now automatically removes styles of destroyed components, which may impact your existing apps in cases you rely on leaked styles. To change this update the value of the `REMOVE_STYLES_ON_COMPONENT_DESTROY` provider to `false`.' },
+  { possibleIn: 1700, necessaryAsOf: 1700, level: ApplicationComplexity.Basic, step: 'v17 router removals', action: 'Make sure you configure `setupTestingRouter`, `canceledNavigationResolution`, `paramsInheritanceStrategy`, `titleStrategy`, `urlUpdateStrategy`, `urlHandlingStrategy`, and `malformedUriErrorHandler` in `provideRouter` or `RouterModule.forRoot` since these properties are now not part of the `Router`\'s public API' },
+  { possibleIn: 1700, necessaryAsOf: 1700, level: ApplicationComplexity.Advanced, step: 'v17 ngDoCheck dynamic components', action: 'For dynamically instantiated components we now execute `ngDoCheck` during change detection if the component is marked as dirty. You may need to update your tests or logic within `ngDoCheck` for dynamically instantiated components.' },
+  { possibleIn: 1700, necessaryAsOf: 1700, level: ApplicationComplexity.Medium, step: 'v17 malformedUriErrorHandler', action: 'Handle URL parsing errors in the `UrlSerializer.parse` instead of `malformedUriErrorHandler` because it\'s now part of the public API surface.' },
+  { possibleIn: 1700, necessaryAsOf: 1700, level: ApplicationComplexity.Medium, step: 'v17 zone deep imports', action: 'Change Zone.js deep imports like `zone.js/bundles/zone-testing.js` and `zone.js/dist/zone` to `zone.js` and `zone.js/testing`.' },
+  { possibleIn: 1700, necessaryAsOf: 1700, level: ApplicationComplexity.Advanced, step: 'v17 absolute redirects', action: 'You may need to adjust your router configuration to prevent infinite redirects after absolute redirects. In v17 we no longer prevent additional redirects after absolute redirects.' },
+  { possibleIn: 1700, necessaryAsOf: 1700, level: ApplicationComplexity.Medium, step: 'v17 AnimationDriver', action: 'Change references to `AnimationDriver.NOOP` to use `NoopAnimationDriver` because `AnimationDriver.NOOP` is now deprecated.' },
+  { possibleIn: 1700, necessaryAsOf: 1700, level: ApplicationComplexity.Basic, step: 'v17 switch strictness', action: 'You may need to adjust the equality check for `NgSwitch` because now it defaults to stricter check with `===` instead of `==`. Angular will log a warning message for the usages where you\'d need to provide an adjustment.' },
+  { possibleIn: 1700, necessaryAsOf: 1700, level: ApplicationComplexity.Advanced, step: 'v17 mutate in signals', action: 'Use `update` instead of `mutate` in Angular Signals. For example `items.mutate(itemsArray => itemsArray.push(newItem));` will now be `items.update(itemsArray => [itemsArray, …newItem]);`' },
+  { possibleIn: 1700, necessaryAsOf: 1700, level: ApplicationComplexity.Medium, step: 'v17 withNoDomReuse', action: 'To disable hydration use `ngSkipHydration` or remove the `provideClientHydration` call from the provider list since `withNoDomReuse` is no longer part of the public API.' },
+  { possibleIn: 1700, necessaryAsOf: 1700, level: ApplicationComplexity.Basic, step: 'v17 paramsInheritanceStrategy', action: 'If you want the child routes of `loadComponent` routes to inherit data from their parent specify the `paramsInheritanceStrategy` to `always`, which in v17 is now set to `emptyOnly`.' },
+
 ];