@angular/router 15.2.0-next.3 → 15.2.0-rc.0

package/fesm2020/testing.mjs

@@ -1,5 +1,5 @@
 /**
- * @license Angular v15.2.0-next.3
+ * @license Angular v15.2.0-rc.0
  * (c) 2010-2022 Google LLC. https://angular.io/
  * License: MIT
  */
@@ -110,15 +110,15 @@ class RouterTestingModule {
         };
     }
 }
-RouterTestingModule.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "15.2.0-next.3", ngImport: i0, type: RouterTestingModule, deps: [], target: i0.ɵɵFactoryTarget.NgModule });
-RouterTestingModule.ɵmod = i0.ɵɵngDeclareNgModule({ minVersion: "14.0.0", version: "15.2.0-next.3", ngImport: i0, type: RouterTestingModule, exports: [RouterModule] });
-RouterTestingModule.ɵinj = i0.ɵɵngDeclareInjector({ minVersion: "12.0.0", version: "15.2.0-next.3", ngImport: i0, type: RouterTestingModule, providers: [
+RouterTestingModule.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "15.2.0-rc.0", ngImport: i0, type: RouterTestingModule, deps: [], target: i0.ɵɵFactoryTarget.NgModule });
+RouterTestingModule.ɵmod = i0.ɵɵngDeclareNgModule({ minVersion: "14.0.0", version: "15.2.0-rc.0", ngImport: i0, type: RouterTestingModule, exports: [RouterModule] });
+RouterTestingModule.ɵinj = i0.ɵɵngDeclareInjector({ minVersion: "12.0.0", version: "15.2.0-rc.0", ngImport: i0, type: RouterTestingModule, providers: [
         ɵROUTER_PROVIDERS,
         provideLocationMocks(),
         ɵwithPreloading(NoPreloading).ɵproviders,
         { provide: ROUTES, multi: true, useValue: [] },
     ], imports: [RouterModule] });
-i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "15.2.0-next.3", ngImport: i0, type: RouterTestingModule, decorators: [{
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "15.2.0-rc.0", ngImport: i0, type: RouterTestingModule, decorators: [{
             type: NgModule,
             args: [{
                     exports: [RouterModule],
@@ -148,17 +148,17 @@ class RootFixtureService {
         return this.fixture;
     }
 }
-RootFixtureService.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "15.2.0-next.3", ngImport: i0, type: RootFixtureService, deps: [], target: i0.ɵɵFactoryTarget.Injectable });
-RootFixtureService.ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "15.2.0-next.3", ngImport: i0, type: RootFixtureService, providedIn: 'root' });
-i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "15.2.0-next.3", ngImport: i0, type: RootFixtureService, decorators: [{
+RootFixtureService.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "15.2.0-rc.0", ngImport: i0, type: RootFixtureService, deps: [], target: i0.ɵɵFactoryTarget.Injectable });
+RootFixtureService.ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "15.2.0-rc.0", ngImport: i0, type: RootFixtureService, providedIn: 'root' });
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "15.2.0-rc.0", ngImport: i0, type: RootFixtureService, decorators: [{
             type: Injectable,
             args: [{ providedIn: 'root' }]
         }] });
 class RootCmp {
 }
-RootCmp.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "15.2.0-next.3", ngImport: i0, type: RootCmp, deps: [], target: i0.ɵɵFactoryTarget.Component });
-RootCmp.ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "14.0.0", version: "15.2.0-next.3", type: RootCmp, isStandalone: true, selector: "ng-component", viewQueries: [{ propertyName: "outlet", first: true, predicate: RouterOutlet, descendants: true }], ngImport: i0, template: '<router-outlet></router-outlet>', isInline: true, dependencies: [{ kind: "directive", type: RouterOutlet, selector: "router-outlet", inputs: ["name"], outputs: ["activate", "deactivate", "attach", "detach"], exportAs: ["outlet"] }] });
-i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "15.2.0-next.3", ngImport: i0, type: RootCmp, decorators: [{
+RootCmp.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "15.2.0-rc.0", ngImport: i0, type: RootCmp, deps: [], target: i0.ɵɵFactoryTarget.Component });
+RootCmp.ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "14.0.0", version: "15.2.0-rc.0", type: RootCmp, isStandalone: true, selector: "ng-component", viewQueries: [{ propertyName: "outlet", first: true, predicate: RouterOutlet, descendants: true }], ngImport: i0, template: '<router-outlet></router-outlet>', isInline: true, dependencies: [{ kind: "directive", type: RouterOutlet, selector: "router-outlet", inputs: ["name"], outputs: ["activate", "deactivate", "attach", "detach"], exportAs: ["outlet"] }] });
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "15.2.0-rc.0", ngImport: i0, type: RootCmp, decorators: [{
             type: Component,
             args: [{
                     standalone: true,

package/fesm2020/upgrade.mjs

@@ -1,5 +1,5 @@
 /**
- * @license Angular v15.2.0-next.3
+ * @license Angular v15.2.0-rc.0
  * (c) 2010-2022 Google LLC. https://angular.io/
  * License: MIT
  */

package/index.d.ts

@@ -1,5 +1,5 @@
 /**
- * @license Angular v15.2.0-next.3
+ * @license Angular v15.2.0-rc.0
  * (c) 2010-2022 Google LLC. https://angular.io/
  * License: MIT
  */
@@ -298,23 +298,6 @@ export declare abstract class BaseRouteReuseStrategy implements RouteReuseStrate
  * class AppModule {}
  * ```
  *
- * You can alternatively provide an in-line function with the `CanActivateFn` signature:
- *
- * ```
- * @NgModule({
- *   imports: [
- *     RouterModule.forRoot([
- *       {
- *         path: 'team/:id',
- *         component: TeamComponent,
- *         canActivate: [(route: ActivatedRouteSnapshot, state: RouterStateSnapshot) => true]
- *       }
- *     ])
- *   ],
- * })
- * class AppModule {}
- * ```
- *
  * @publicApi
  * @deprecated Use plain JavaScript functions instead.
  * @see CanActivateFn
@@ -379,30 +362,10 @@ export declare interface CanActivate {
  * class AppModule {}
  * ```
  *
- * You can alternatively provide an in-line function with the `CanActivateChildFn` signature:
- *
- * ```
- * @NgModule({
- *   imports: [
- *     RouterModule.forRoot([
- *       {
- *         path: 'root',
- *         canActivateChild: [(route: ActivatedRouteSnapshot, state: RouterStateSnapshot) => true],
- *         children: [
- *           {
- *             path: 'team/:id',
- *             component: TeamComponent
- *           }
- *         ]
- *       }
- *     ])
- *   ],
- * })
- * class AppModule {}
- * ```
- *
  * @publicApi
- * @deprecated Use plain JavaScript functions instead.
+ * @deprecated Class-based `Route` guards are deprecated in favor of functional guards. An
+ *     injectable class can be used as a functional guard using the `inject` function:
+ *     `canActivateChild: [() => inject(myGuard).canActivateChild()]`.
  * @see CanActivateChildFn
  */
 export declare interface CanActivateChild {
@@ -412,8 +375,16 @@ export declare interface CanActivateChild {
 /**
  * The signature of a function used as a `canActivateChild` guard on a `Route`.
  *
+ * If all guards return `true`, navigation continues. If any guard returns `false`,
+ * navigation is cancelled. If any guard returns a `UrlTree`, the current navigation
+ * is cancelled and a new navigation begins to the `UrlTree` returned from the guard.
+ *
+ * The following example implements a `canActivate` function that checks whether the
+ * current user has permission to activate the requested route.
+ *
+ * {@example router/route_functional_guards.ts region="CanActivateChildFn"}
+ *
  * @publicApi
- * @see `CanActivateChild`
  * @see `Route`
  */
 export declare type CanActivateChildFn = (childRoute: ActivatedRouteSnapshot, state: RouterStateSnapshot) => Observable<boolean | UrlTree> | Promise<boolean | UrlTree> | boolean | UrlTree;
@@ -421,8 +392,21 @@ export declare type CanActivateChildFn = (childRoute: ActivatedRouteSnapshot, st
 /**
  * The signature of a function used as a `canActivate` guard on a `Route`.
  *
+ * If all guards return `true`, navigation continues. If any guard returns `false`,
+ * navigation is cancelled. If any guard returns a `UrlTree`, the current navigation
+ * is cancelled and a new navigation begins to the `UrlTree` returned from the guard.
+ *
+ * The following example implements and uses a `CanActivateChildFn` that checks whether the
+ * current user has permission to activate the requested route.
+ *
+ * {@example router/route_functional_guards.ts region="CanActivateFn"}
+
+ * Here, the defined guard function is provided as part of the `Route` object
+ * in the router configuration:
+
+ * {@example router/route_functional_guards.ts region="CanActivateFnInRoute"}
+ *
  * @publicApi
- * @see `CanActivate`
  * @see `Route`
  */
 export declare type CanActivateFn = (route: ActivatedRouteSnapshot, state: RouterStateSnapshot) => Observable<boolean | UrlTree> | Promise<boolean | UrlTree> | boolean | UrlTree;
@@ -481,26 +465,10 @@ export declare type CanActivateFn = (route: ActivatedRouteSnapshot, state: Route
  * class AppModule {}
  * ```
  *
- * You can alternatively provide an in-line function with the `CanDeactivateFn` signature:
- *
- * ```
- * @NgModule({
- *   imports: [
- *     RouterModule.forRoot([
- *       {
- *         path: 'team/:id',
- *         component: TeamComponent,
- *         canDeactivate: [(component: TeamComponent, currentRoute: ActivatedRouteSnapshot,
- * currentState: RouterStateSnapshot, nextState: RouterStateSnapshot) => true]
- *       }
- *     ])
- *   ],
- * })
- * class AppModule {}
- * ```
- *
  * @publicApi
- * @deprecated Use plain JavaScript functions instead.
+ * @deprecated Class-based `Route` guards are deprecated in favor of functional guards. An
+ *     injectable class can be used as a functional guard using the `inject` function:
+ *     `canDeactivate: [() => inject(myGuard).canDeactivate()]`.
  * @see CanDeactivateFn
  */
 export declare interface CanDeactivate<T> {
@@ -510,8 +478,16 @@ export declare interface CanDeactivate<T> {
 /**
  * The signature of a function used as a `canDeactivate` guard on a `Route`.
  *
+ * If all guards return `true`, navigation continues. If any guard returns `false`,
+ * navigation is cancelled. If any guard returns a `UrlTree`, the current navigation
+ * is cancelled and a new navigation begins to the `UrlTree` returned from the guard.
+ *
+ * The following example implements and uses a `CanDeactivateFn` that checks whether the
+ * user component has unsaved changes before navigating away from the route.
+ *
+ * {@example router/route_functional_guards.ts region="CanDeactivateFn"}
+ *
  * @publicApi
- * @see `CanDeactivate`
  * @see `Route`
  */
 export declare type CanDeactivateFn<T> = (component: T, currentRoute: ActivatedRouteSnapshot, currentState: RouterStateSnapshot, nextState: RouterStateSnapshot) => Observable<boolean | UrlTree> | Promise<boolean | UrlTree> | boolean | UrlTree;
@@ -567,24 +543,6 @@ export declare type CanDeactivateFn<T> = (component: T, currentRoute: ActivatedR
  * class AppModule {}
  * ```
  *
- * You can alternatively provide an in-line function with the `CanLoadFn` signature:
- *
- * ```
- * @NgModule({
- *   imports: [
- *     RouterModule.forRoot([
- *       {
- *         path: 'team/:id',
- *         component: TeamComponent,
- *         loadChildren: () => import('./team').then(mod => mod.TeamModule),
- *         canLoad: [(route: Route, segments: UrlSegment[]) => true]
- *       }
- *     ])
- *   ],
- * })
- * class AppModule {}
- * ```
- *
  * @publicApi
  * @deprecated Use `CanMatchFn` instead
  */
@@ -662,30 +620,10 @@ export declare type CanLoadFn = (route: Route, segments: UrlSegment[]) => Observ
  * `team/:id` URL, but would load the `NotFoundComponent` because the `Route` for `'team/:id'`
  * could not be used for a URL match but the catch-all `**` `Route` did instead.
  *
- * You can alternatively provide an in-line function with the `CanMatchFn` signature:
- *
- * ```
- * @NgModule({
- *   imports: [
- *     RouterModule.forRoot([
- *       {
- *         path: 'team/:id',
- *         component: TeamComponent,
- *         loadChildren: () => import('./team').then(mod => mod.TeamModule),
- *         canMatch: [(route: Route, segments: UrlSegment[]) => true]
- *       },
- *       {
- *         path: '**',
- *         component: NotFoundComponent
- *       }
- *     ])
- *   ],
- * })
- * class AppModule {}
- * ```
- *
  * @publicApi
- * @deprecated Use plain JavaScript functions instead.
+ * @deprecated Class-based `Route` guards are deprecated in favor of functional guards. An
+ *     injectable class can be used as a functional guard using the `inject` function:
+ *     `canMatch: [() => inject(myGuard).canMatch()]`.
  * @see CanMatchFn
  */
 export declare interface CanMatch {
@@ -693,10 +631,18 @@ export declare interface CanMatch {
 }
 
 /**
- * The signature of a function used as a `CanMatch` guard on a `Route`.
+ * The signature of a function used as a `canMatch` guard on a `Route`.
+ *
+ * If all guards return `true`, navigation continues and the `Router` will use the `Route` during
+ * activation. If any guard returns `false`, the `Route` is skipped for matching and other `Route`
+ * configurations are processed instead.
+ *
+ * The following example implements and uses a `CanMatchFn` that checks whether the
+ * current user has permission to access the team page.
+ *
+ * {@example router/route_functional_guards.ts region="CanMatchFn"}
  *
  * @publicApi
- * @see `CanMatch`
  * @see `Route`
  */
 export declare type CanMatchFn = (route: Route, segments: UrlSegment[]) => Observable<boolean | UrlTree> | Promise<boolean | UrlTree> | boolean | UrlTree;
@@ -924,7 +870,8 @@ export declare class DefaultUrlSerializer implements UrlSerializer {
 /**
  * The `InjectionToken` and `@Injectable` classes for guards and resolvers are deprecated in favor
  * of plain JavaScript functions instead.. Dependency injection can still be achieved using the
- * `inject` function from `@angular/core`.
+ * `inject` function from `@angular/core` and an injectable class can be used as a functional guard
+ * using `inject`: `canActivate: [() => inject(myGuard).canActivate()]`.
  *
  * @deprecated
  * @see CanMatchFn
@@ -2057,29 +2004,6 @@ export declare type QueryParamsHandling = 'merge' | 'preserve' | '';
  * export class AppRoutingModule {}
  * ```
  *
- * You can alternatively provide an in-line function with the `ResolveFn` signature:
- *
- * ```
- * export const myHero: Hero = {
- *   // ...
- * }
- *
- * @NgModule({
- *   imports: [
- *     RouterModule.forRoot([
- *       {
- *         path: 'detail/:id',
- *         component: HeroComponent,
- *         resolve: {
- *           hero: (route: ActivatedRouteSnapshot, state: RouterStateSnapshot) => myHero
- *         }
- *       }
- *     ])
- *   ],
- * })
- * export class AppModule {}
- * ```
- *
  * And you can access to your resolved data from `HeroComponent`:
  *
  * ```
@@ -2124,7 +2048,9 @@ export declare type QueryParamsHandling = 'merge' | 'preserve' | '';
  * The order of execution is: BaseGuard, ChildGuard, BaseDataResolver, ChildDataResolver.
  *
  * @publicApi
- * @deprecated Use plain JavaScript functions instead.
+ * @deprecated Class-based `Route` resolvers are deprecated in favor of functional resolvers. An
+ * injectable class can be used as a functional guard using the `inject` function: `resolve:
+ * {'user': () => inject(UserResolver).resolve()}`.
  * @see ResolveFn
  */
 export declare interface Resolve<T> {
@@ -2169,9 +2095,44 @@ export declare class ResolveEnd extends RouterEvent {
 
 /**
  * Function type definition for a data provider.
+
+ * A data provider can be used with the router to resolve data during navigation.
+ * The router waits for the data to be resolved before the route is finally activated.
+ *
+ * The following example implements a function that retrieves the data
+ * needed to activate the requested route.
+ *
+ * {@example router/route_functional_guards.ts region="ResolveFn"}
+ *
+ * And you can access to your resolved data from `HeroComponent`:
+ *
+ * {@example router/route_functional_guards.ts region="ResolveDataUse"}
+ *
+ * @usageNotes
+ *
+ * When both guard and resolvers are specified, the resolvers are not executed until
+ * all guards have run and succeeded.
+ * For example, consider the following route configuration:
+ *
+ * ```
+ * {
+ *  path: 'base'
+ *  canActivate: [baseGuard],
+ *  resolve: {data: baseDataResolver}
+ *  children: [
+ *   {
+ *     path: 'child',
+ *     canActivate: [childGuard],
+ *     component: ChildComponent,
+ *     resolve: {childData: childDataResolver}
+ *    }
+ *  ]
+ * }
+ * ```
+ * The order of execution is: baseGuard, childGuard, baseDataResolver, childDataResolver.
  *
- * @see `Route#resolve`.
  * @publicApi
+ * @see Route
  */
 export declare type ResolveFn<T> = (route: ActivatedRouteSnapshot, state: RouterStateSnapshot) => Observable<T> | Promise<T> | T;
 
@@ -2664,8 +2625,8 @@ export declare class Router {
      * A handler for navigation errors in this NgModule.
      *
      * @deprecated Subscribe to the `Router` events and watch for `NavigationError` instead.
-     *   `provideRouter` has the `withErrorHandler` feature to make this easier.
-     * @see `withErrorHandler`
+     *   `provideRouter` has the `withNavigationErrorHandler` feature to make this easier.
+     * @see `withNavigationErrorHandler`
      */
     errorHandler: (error: any) => any;
     /**
@@ -4480,7 +4441,7 @@ export declare function withInMemoryScrolling(options?: InMemoryScrollingOptions
  *   {
  *     providers: [
  *       provideRouter(appRoutes, withNavigationErrorHandler((e: NavigationError) =>
- * inject(MyErrorTracker).trackError(e))
+ * inject(MyErrorTracker).trackError(e)))
  *     ]
  *   }
  * );

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@angular/router",
-  "version": "15.2.0-next.3",
+  "version": "15.2.0-rc.0",
   "description": "Angular - the routing library",
   "keywords": [
     "angular",
@@ -24,9 +24,9 @@
     "tslib": "^2.3.0"
   },
   "peerDependencies": {
-    "@angular/core": "15.2.0-next.3",
-    "@angular/common": "15.2.0-next.3",
-    "@angular/platform-browser": "15.2.0-next.3",
+    "@angular/core": "15.2.0-rc.0",
+    "@angular/common": "15.2.0-rc.0",
+    "@angular/platform-browser": "15.2.0-rc.0",
     "rxjs": "^6.5.3 || ^7.4.0"
   },
   "ng-update": {

package/testing/index.d.ts

@@ -1,5 +1,5 @@
 /**
- * @license Angular v15.2.0-next.3
+ * @license Angular v15.2.0-rc.0
  * (c) 2010-2022 Google LLC. https://angular.io/
  * License: MIT
  */

package/upgrade/index.d.ts

@@ -1,5 +1,5 @@
 /**
- * @license Angular v15.2.0-next.3
+ * @license Angular v15.2.0-rc.0
  * (c) 2010-2022 Google LLC. https://angular.io/
  * License: MIT
  */