@angular/router 18.0.0-next.3 → 18.0.0-next.5

package/fesm2022/testing.mjs

@@ -1,6 +1,6 @@
 /**
- * @license Angular v18.0.0-next.3
- * (c) 2010-2022 Google LLC. https://angular.io/
+ * @license Angular v18.0.0-next.5
+ * (c) 2010-2024 Google LLC. https://angular.io/
  * License: MIT
  */
 
@@ -59,16 +59,16 @@ class RouterTestingModule {
             ],
         };
     }
-    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "18.0.0-next.3", ngImport: i0, type: RouterTestingModule, deps: [], target: i0.ɵɵFactoryTarget.NgModule }); }
-    static { this.ɵmod = i0.ɵɵngDeclareNgModule({ minVersion: "14.0.0", version: "18.0.0-next.3", ngImport: i0, type: RouterTestingModule, exports: [RouterModule] }); }
-    static { this.ɵinj = i0.ɵɵngDeclareInjector({ minVersion: "12.0.0", version: "18.0.0-next.3", ngImport: i0, type: RouterTestingModule, providers: [
+    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "18.0.0-next.5", ngImport: i0, type: RouterTestingModule, deps: [], target: i0.ɵɵFactoryTarget.NgModule }); }
+    static { this.ɵmod = i0.ɵɵngDeclareNgModule({ minVersion: "14.0.0", version: "18.0.0-next.5", ngImport: i0, type: RouterTestingModule, exports: [RouterModule] }); }
+    static { this.ɵinj = i0.ɵɵngDeclareInjector({ minVersion: "12.0.0", version: "18.0.0-next.5", 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: "18.0.0-next.3", ngImport: i0, type: RouterTestingModule, decorators: [{
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "18.0.0-next.5", ngImport: i0, type: RouterTestingModule, decorators: [{
             type: NgModule,
             args: [{
                     exports: [RouterModule],
@@ -97,18 +97,18 @@ class RootFixtureService {
         this.fixture.detectChanges();
         return this.fixture;
     }
-    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "18.0.0-next.3", ngImport: i0, type: RootFixtureService, deps: [], target: i0.ɵɵFactoryTarget.Injectable }); }
-    static { this.ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "18.0.0-next.3", ngImport: i0, type: RootFixtureService, providedIn: 'root' }); }
+    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "18.0.0-next.5", ngImport: i0, type: RootFixtureService, deps: [], target: i0.ɵɵFactoryTarget.Injectable }); }
+    static { this.ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "18.0.0-next.5", ngImport: i0, type: RootFixtureService, providedIn: 'root' }); }
 }
-i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "18.0.0-next.3", ngImport: i0, type: RootFixtureService, decorators: [{
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "18.0.0-next.5", ngImport: i0, type: RootFixtureService, decorators: [{
             type: Injectable,
             args: [{ providedIn: 'root' }]
         }] });
 class RootCmp {
-    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "18.0.0-next.3", ngImport: i0, type: RootCmp, deps: [], target: i0.ɵɵFactoryTarget.Component }); }
-    static { this.ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "14.0.0", version: "18.0.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"] }] }); }
+    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "18.0.0-next.5", ngImport: i0, type: RootCmp, deps: [], target: i0.ɵɵFactoryTarget.Component }); }
+    static { this.ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "14.0.0", version: "18.0.0-next.5", 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: "18.0.0-next.3", ngImport: i0, type: RootCmp, decorators: [{
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "18.0.0-next.5", ngImport: i0, type: RootCmp, decorators: [{
             type: Component,
             args: [{
                     standalone: true,

package/fesm2022/upgrade.mjs

@@ -1,6 +1,6 @@
 /**
- * @license Angular v18.0.0-next.3
- * (c) 2010-2022 Google LLC. https://angular.io/
+ * @license Angular v18.0.0-next.5
+ * (c) 2010-2024 Google LLC. https://angular.io/
  * License: MIT
  */
 

package/index.d.ts

@@ -1,6 +1,6 @@
 /**
- * @license Angular v18.0.0-next.3
- * (c) 2010-2022 Google LLC. https://angular.io/
+ * @license Angular v18.0.0-next.5
+ * (c) 2010-2024 Google LLC. https://angular.io/
  * License: MIT
  */
 
@@ -48,7 +48,7 @@ import { Version } from '@angular/core';
  * {@example router/activated-route/module.ts region="activated-route"
  *     header="activated-route.component.ts"}
  *
- * @see [Getting route information](guide/router#getting-route-information)
+ * @see [Getting route information](guide/routing/common-router-tasks#getting-route-information)
  *
  * @publicApi
  */
@@ -401,12 +401,44 @@ export declare type CanActivateChildFn = (childRoute: ActivatedRouteSnapshot, st
  * The following example implements and uses a `CanActivateFn` that checks whether the
  * current user has permission to activate the requested route.
  *
- * {@example router/route_functional_guards.ts region="CanActivateFn"}
-
+ * ```ts
+ * @Injectable()
+ * class UserToken {}
+ *
+ * @Injectable()
+ * class PermissionsService {
+ *   canActivate(currentUser: UserToken, userId: string): boolean {
+ *     return true;
+ *   }
+ *   canMatch(currentUser: UserToken): boolean {
+ *     return true;
+ *   }
+ * }
+ *
+ * const canActivateTeam: CanActivateFn = (
+ *   route: ActivatedRouteSnapshot,
+ *   state: RouterStateSnapshot,
+ * ) => {
+ *   return inject(PermissionsService).canActivate(inject(UserToken), route.params['id']);
+ * };
+ * ```
+ *
  * 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"}
+ *
+ * ```ts
+ * bootstrapApplication(App, {
+ *    providers: [
+ *      provideRouter([
+ *        {
+ *          path: 'team/:id',
+ *          component: TeamComponent,
+ *          canActivate: [canActivateTeam],
+ *        },
+ *      ]),
+ *    ],
+ *  });
+ * ```
  *
  * @publicApi
  * @see {@link Route}
@@ -942,7 +974,7 @@ export declare type EnabledBlockingInitialNavigationFeature = RouterFeature<Rout
  *
  * * [NavigationStart](api/router/NavigationStart): Navigation starts.
  * * [RouteConfigLoadStart](api/router/RouteConfigLoadStart): Before
- * the router [lazy loads](/guide/router#lazy-loading) a route configuration.
+ * the router [lazy loads](guide/routing/common-router-tasks#lazy-loading) a route configuration.
  * * [RouteConfigLoadEnd](api/router/RouteConfigLoadEnd): After a route has been lazy loaded.
  * * [RoutesRecognized](api/router/RoutesRecognized): When the router parses the URL
  * and the routes are recognized.
@@ -1073,7 +1105,7 @@ export declare interface ExtraOptions extends InMemoryScrollingOptions, RouterCo
 /**
  * The supported types that can be returned from a `Router` guard.
  *
- * @see [Routing tutorial](guide/router-tutorial-toh#milestone-5-route-guards)
+ * @see [Routing guide](guide/routing/common-router-tasks#preventing-unauthorized-access)
  * @publicApi
  */
 export declare type GuardResult = boolean | UrlTree | RedirectCommand;
@@ -1503,7 +1535,7 @@ export declare interface Navigation {
  *
  * @see {@link Router#navigate}
  * @see {@link Router#navigateByUrl}
- * @see [Routing and Navigation guide](guide/router)
+ * @see [Routing and Navigation guide](guide/routing/common-router-tasks)
  *
  * @publicApi
  */
@@ -1732,7 +1764,7 @@ export declare type NavigationErrorHandlerFeature = RouterFeature<RouterFeatureK
  * @see {@link Router#navigate}
  * @see {@link Router#navigateByUrl}
  * @see {@link Router#createurltree}
- * @see [Routing and Navigation guide](guide/router)
+ * @see [Routing and Navigation guide](guide/routing/common-router-tasks)
  * @see {@link UrlCreationOptions}
  * @see {@link NavigationBehaviorOptions}
  *
@@ -2090,7 +2122,29 @@ export declare type QueryParamsHandling = 'merge' | 'preserve' | '';
  * navigation should go to and the optional `navigationBehaviorOptions` can provide more information
  * about _how_ to perform the navigation.
  *
- * @see [Routing tutorial](guide/router-tutorial-toh#milestone-5-route-guards)
+ * ```ts
+ * const route: Route = {
+ *   path: "user/:userId",
+ *   component: User,
+ *   canActivate: [
+ *     () => {
+ *       const router = inject(Router);
+ *       const authService = inject(AuthenticationService);
+ *
+ *       if (!authService.isLoggedIn()) {
+ *         const loginPath = router.parseUrl("/login");
+ *         return new RedirectCommand(loginPath, {
+ *           skipLocationChange: "true",
+ *         });
+ *       }
+ *
+ *       return true;
+ *     },
+ *   ],
+ * };
+ * ```
+ * @see [Routing guide](guide/routing/common-router-tasks#preventing-unauthorized-access)
+ *
  * @publicApi
  */
 export declare class RedirectCommand {
@@ -2260,20 +2314,81 @@ 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.
  *
+ * A resolver can also redirect a `RedirectCommand` and the Angular router will use
+ * it to redirect the current navigation to the new destination.
+ *
+ * @usageNotes
+ *
  * The following example implements a function that retrieves the data
  * needed to activate the requested route.
  *
- * {@example router/route_functional_guards.ts region="ResolveFn"}
+ * ```ts
+ * interface Hero {
+ *   name: string;
+ * }
+ * @Injectable()
+ * export class HeroService {
+ *   getHero(id: string) {
+ *     return {name: `Superman-${id}`};
+ *   }
+ * }
+ *
+ * export const heroResolver: ResolveFn<Hero> = (
+ *   route: ActivatedRouteSnapshot,
+ *   state: RouterStateSnapshot,
+ * ) => {
+ *   return inject(HeroService).getHero(route.paramMap.get('id')!);
+ * };
+ *
+ * bootstrapApplication(App, {
+ *   providers: [
+ *     provideRouter([
+ *       {
+ *         path: 'detail/:id',
+ *         component: HeroDetailComponent,
+ *         resolve: {hero: heroResolver},
+ *       },
+ *     ]),
+ *   ],
+ * });
+ * ```
  *
  * And you can access to your resolved data from `HeroComponent`:
  *
- * {@example router/route_functional_guards.ts region="ResolveDataUse"}
+ * ```ts
+ * @Component({template: ''})
+ * export class HeroDetailComponent {
+ *   private activatedRoute = inject(ActivatedRoute);
  *
- * @usageNotes
+ *   ngOnInit() {
+ *     this.activatedRoute.data.subscribe(({hero}) => {
+ *       // do something with your resolved data ...
+ *     });
+ *   }
+ * }
+ * ```
+ *
+ * If resolved data cannot be retrieved, you may want to redirect the user
+ * to a new page instead:
+ *
+ * ```ts
+ * export const heroResolver: ResolveFn<Hero> = async (
+ *   route: ActivatedRouteSnapshot,
+ *   state: RouterStateSnapshot,
+ * ) => {
+ *   const router = inject(Router);
+ *   const heroService = inject(HeroService);
+ *   try {
+ *     return await heroService.getHero(route.paramMap.get('id')!);
+ *   } catch {
+ *     return new RedirectCommand(router.parseUrl('/404'));
+ *   }
+ * };
+ * ```
  *
  * When both guard and resolvers are specified, the resolvers are not executed until
  * all guards have run and succeeded.
@@ -2338,7 +2453,7 @@ export declare class ResolveStart extends RouterEvent {
  * Supports static, parameterized, redirect, and wildcard routes, as well as
  * custom route data and resolve methods.
  *
- * For detailed usage information, see the [Routing Guide](guide/router).
+ * For detailed usage information, see the [Routing Guide](guide/routing/common-router-tasks).
  *
  * @usageNotes
  *
@@ -2776,7 +2891,7 @@ declare class RoutedComponentInputBinder {
  * A service that provides navigation among views and URL manipulation capabilities.
  *
  * @see {@link Route}
- * @see [Routing and Navigation Guide](guide/router).
+ * @see [Routing and Navigation Guide](guide/routing/common-router-tasks).
  *
  * @ngModule RouterModule
  *
@@ -2787,7 +2902,6 @@ export declare class Router {
     private get rawUrlTree();
     private disposed;
     private nonRouterCurrentEntryChangeSubscription?;
-    private isNgZoneEnabled;
     private readonly console;
     private readonly stateManager;
     private readonly options;
@@ -2973,7 +3087,7 @@ export declare class Router {
      * router.navigateByUrl("/team/33/user/11", { skipLocationChange: true });
      * ```
      *
-     * @see [Routing and Navigation guide](guide/router)
+     * @see [Routing and Navigation guide](guide/routing/common-router-tasks)
      *
      */
     navigateByUrl(url: string | UrlTree, extras?: NavigationBehaviorOptions): Promise<boolean>;
@@ -3004,7 +3118,7 @@ export declare class Router {
      * router.navigate(['team', 33, 'user', 11], {relativeTo: route, skipLocationChange: true});
      * ```
      *
-     * @see [Routing and Navigation guide](guide/router)
+     * @see [Routing and Navigation guide](guide/routing/common-router-tasks)
      *
      */
     navigate(commands: any[], extras?: NavigationExtras): Promise<boolean>;
@@ -3190,7 +3304,7 @@ export declare abstract class RouteReuseStrategy {
  * ```
  *
  * @see {@link Event}
- * @see [Router events summary](guide/router-reference#router-events)
+ * @see [Router events summary](guide/routing/router-reference#router-events)
  * @publicApi
  */
 export declare class RouterEvent {
@@ -3619,7 +3733,7 @@ export declare class RouterLinkActive implements OnChanges, OnDestroy, AfterCont
  * * The `forChild()` method creates an `NgModule` that contains all the directives and the given
  * routes, but does not include the `Router` service.
  *
- * @see [Routing and Navigation guide](guide/router) for an
+ * @see [Routing and Navigation guide](guide/routing/common-router-tasks) for an
  * overview of how the `Router` service should be used.
  *
  * @publicApi
@@ -3710,8 +3824,6 @@ export declare class RouterModule {
  *   (detach)='onDetach($event)'></router-outlet>
  * ```
  *
- * @see [Routing tutorial](guide/router-tutorial-toh#named-outlets "Example of a named
- * outlet and secondary route configuration").
  * @see {@link RouterLink}
  * @see {@link Route}
  * @ngModule RouterModule
@@ -3724,7 +3836,6 @@ export declare class RouterOutlet implements OnDestroy, OnInit, RouterOutletCont
     /**
      * The name of the outlet
      *
-     * @see [named outlets](guide/router-tutorial-toh#displaying-multiple-routes-in-named-outlets)
      */
     name: string;
     activateEvents: EventEmitter<any>;
@@ -3912,7 +4023,7 @@ export declare class RouterPreloader implements OnDestroy {
  * ```
  *
  * @see {@link ActivatedRoute}
- * @see [Getting route information](guide/router#getting-route-information)
+ * @see [Getting route information](guide/routing/common-router-tasks#getting-route-information)
  *
  * @publicApi
  */
@@ -3974,7 +4085,7 @@ export declare const ROUTES: InjectionToken<Route[][]>;
  *
  * @see {@link Route}
  * @see {@link Router}
- * @see [Router configuration guide](guide/router-reference#configuration)
+ * @see [Router configuration guide](guide/routing/router-reference#configuration)
  * @publicApi
  */
 export declare type Routes = Route[];
@@ -4067,7 +4178,7 @@ export declare class Scroll {
  * incorporate titles in named outlets.
  *
  * @publicApi
- * @see [Page title guide](guide/router#setting-the-page-title)
+ * @see [Page title guide](guide/routing/common-router-tasks#setting-the-page-title)
  */
 export declare abstract class TitleStrategy {
     /** Performs the application title update. */
@@ -4107,7 +4218,7 @@ declare class TreeNode<T> {
  *
  * @see {@link Router#navigate}
  * @see {@link Router#createUrlTree}
- * @see [Routing and Navigation guide](guide/router)
+ * @see [Routing and Navigation guide](guide/routing/common-router-tasks)
  *
  * @publicApi
  */
@@ -4655,7 +4766,7 @@ export declare function withInMemoryScrolling(options?: InMemoryScrollingOptions
 /**
  * Provides a function which is called when a navigation error occurs.
  *
- * This function is run inside application's [injection context](guide/dependency-injection-context)
+ * This function is run inside application's [injection context](guide/di/dependency-injection-context)
  * so you can use the [`inject`](api/core/inject) function.
  *
  * @usageNotes

package/package.json

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

package/testing/index.d.ts

@@ -1,6 +1,6 @@
 /**
- * @license Angular v18.0.0-next.3
- * (c) 2010-2022 Google LLC. https://angular.io/
+ * @license Angular v18.0.0-next.5
+ * (c) 2010-2024 Google LLC. https://angular.io/
  * License: MIT
  */
 

package/upgrade/index.d.ts

@@ -1,6 +1,6 @@
 /**
- * @license Angular v18.0.0-next.3
- * (c) 2010-2022 Google LLC. https://angular.io/
+ * @license Angular v18.0.0-next.5
+ * (c) 2010-2024 Google LLC. https://angular.io/
  * License: MIT
  */