@angular/router 18.0.0-next.2 → 18.0.0-next.4

package/fesm2022/testing.mjs

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

package/fesm2022/upgrade.mjs

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

package/index.d.ts

@@ -1,6 +1,6 @@
 /**
- * @license Angular v18.0.0-next.2
- * (c) 2010-2022 Google LLC. https://angular.io/
+ * @license Angular v18.0.0-next.4
+ * (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
  */
@@ -690,7 +690,10 @@ export declare class ChildActivationStart {
  * @publicApi
  */
 export declare class ChildrenOutletContexts {
+    private parentInjector;
     private contexts;
+    /** @nodoc */
+    constructor(parentInjector: EnvironmentInjector);
     /** Called when a `RouterOutlet` directive is instantiated */
     onChildOutletCreated(childName: string, outlet: RouterOutletContract): void;
     /**
@@ -939,7 +942,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.
@@ -1070,7 +1073,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;
@@ -1500,7 +1503,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
  */
@@ -1729,7 +1732,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}
  *
@@ -1908,11 +1911,12 @@ export declare type OnSameUrlNavigation = 'reload' | 'ignore';
  * @publicApi
  */
 export declare class OutletContext {
+    injector: EnvironmentInjector;
     outlet: RouterOutletContract | null;
     route: ActivatedRoute | null;
-    injector: EnvironmentInjector | null;
     children: ChildrenOutletContexts;
     attachRef: ComponentRef<any> | null;
+    constructor(injector: EnvironmentInjector);
 }
 
 /**
@@ -2048,7 +2052,7 @@ export declare const PRIMARY_OUTLET = "primary";
 export declare function provideRouter(routes: Routes, ...features: RouterFeatures[]): EnvironmentProviders;
 
 /**
- * Registers a [DI provider](guide/glossary#provider) for a set of routes.
+ * Registers a DI provider for a set of routes.
  * @param routes The route configuration to provide.
  *
  * @usageNotes
@@ -2086,7 +2090,7 @@ 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)
+ * @see [Routing guide](guide/routing/common-router-tasks#preventing-unauthorized-access)
  * @publicApi
  */
 export declare class RedirectCommand {
@@ -2217,6 +2221,11 @@ export declare interface Resolve<T> {
  *
  * Represents the resolved data associated with a particular route.
  *
+ * Returning a `RedirectCommand` directs the router to cancel the current navigation and redirect to
+ * the location provided in the `RedirectCommand`. Note that there are no ordering guarantees when
+ * resolvers execute. If multiple resolvers would return a `RedirectCommand`, only the first one
+ * returned will be used.
+ *
  * @see {@link Route#resolve}
  *
  * @publicApi
@@ -2290,7 +2299,7 @@ export declare class ResolveEnd extends RouterEvent {
  * @publicApi
  * @see {@link Route}
  */
-export declare type ResolveFn<T> = (route: ActivatedRouteSnapshot, state: RouterStateSnapshot) => MaybeAsync<T>;
+export declare type ResolveFn<T> = (route: ActivatedRouteSnapshot, state: RouterStateSnapshot) => MaybeAsync<T | RedirectCommand>;
 
 /**
  * An event triggered at the start of the Resolve phase of routing.
@@ -2329,7 +2338,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
  *
@@ -2767,7 +2776,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
  *
@@ -2964,7 +2973,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>;
@@ -2995,7 +3004,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>;
@@ -3026,14 +3035,14 @@ export declare class Router {
 }
 
 /**
- * A [DI token](guide/glossary/#di-token) for the router service.
+ * A DI token for the router service.
  *
  * @publicApi
  */
 export declare const ROUTER_CONFIGURATION: InjectionToken<ExtraOptions>;
 
 /**
- * A [DI token](guide/glossary/#di-token) for the router initializer that
+ * A DI token for the router initializer that
  * is called after the app is bootstrapped.
  *
  * @publicApi
@@ -3181,7 +3190,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 {
@@ -3610,7 +3619,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
@@ -3701,8 +3710,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
@@ -3715,7 +3722,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>;
@@ -3733,7 +3739,6 @@ export declare class RouterOutlet implements OnDestroy, OnInit, RouterOutletCont
     private parentContexts;
     private location;
     private changeDetector;
-    private environmentInjector;
     private inputBinder;
     /** @nodoc */
     readonly supportsBindingToComponentInputs = true;
@@ -3762,7 +3767,7 @@ export declare class RouterOutlet implements OnDestroy, OnInit, RouterOutletCont
      */
     attach(ref: ComponentRef<any>, activatedRoute: ActivatedRoute): void;
     deactivate(): void;
-    activateWith(activatedRoute: ActivatedRoute, environmentInjector?: EnvironmentInjector | null): void;
+    activateWith(activatedRoute: ActivatedRoute, environmentInjector: EnvironmentInjector): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<RouterOutlet, never>;
     static ɵdir: i0.ɵɵDirectiveDeclaration<RouterOutlet, "router-outlet", ["outlet"], { "name": { "alias": "name"; "required": false; }; }, { "activateEvents": "activate"; "deactivateEvents": "deactivate"; "attachEvents": "attach"; "detachEvents": "detach"; }, never, never, true, never>;
 }
@@ -3800,7 +3805,7 @@ export declare interface RouterOutletContract {
     /**
      * Called by the `Router` when the outlet should activate (create a component).
      */
-    activateWith(activatedRoute: ActivatedRoute, environmentInjector: EnvironmentInjector | null): void;
+    activateWith(activatedRoute: ActivatedRoute, environmentInjector: EnvironmentInjector): void;
     /**
      * A request to destroy the currently activated component.
      *
@@ -3904,7 +3909,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
  */
@@ -3948,7 +3953,7 @@ export declare class RouterStateSnapshot extends Tree<ActivatedRouteSnapshot> {
 }
 
 /**
- * The [DI token](guide/glossary/#di-token) for a router configuration.
+ * The DI token for a router configuration.
  *
  * `ROUTES` is a low level API for router configuration via dependency injection.
  *
@@ -3966,7 +3971,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[];
@@ -4059,7 +4064,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. */
@@ -4099,7 +4104,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
  */
@@ -4645,10 +4650,9 @@ export declare function withHashLocation(): RouterHashLocationFeature;
 export declare function withInMemoryScrolling(options?: InMemoryScrollingOptions): InMemoryScrollingFeature;
 
 /**
- * Subscribes to the Router's navigation events and calls the given function when a
- * `NavigationError` happens.
+ * 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
@@ -4674,7 +4678,7 @@ export declare function withInMemoryScrolling(options?: InMemoryScrollingOptions
  *
  * @publicApi
  */
-export declare function withNavigationErrorHandler(fn: (error: NavigationError) => void): NavigationErrorHandlerFeature;
+export declare function withNavigationErrorHandler(handler: (error: NavigationError) => void): NavigationErrorHandlerFeature;
 
 /**
  * Allows to configure a preloading strategy to use. The strategy is configured by providing a

package/package.json

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

package/testing/index.d.ts

@@ -1,6 +1,6 @@
 /**
- * @license Angular v18.0.0-next.2
- * (c) 2010-2022 Google LLC. https://angular.io/
+ * @license Angular v18.0.0-next.4
+ * (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.2
- * (c) 2010-2022 Google LLC. https://angular.io/
+ * @license Angular v18.0.0-next.4
+ * (c) 2010-2024 Google LLC. https://angular.io/
  * License: MIT
  */