@angular/router 14.2.0-next.0 → 14.2.0

package/index.d.ts

@@ -1,5 +1,5 @@
 /**
- * @license Angular v14.2.0-next.0
+ * @license Angular v14.2.0
  * (c) 2010-2022 Google LLC. https://angular.io/
  * License: MIT
  */
@@ -262,7 +262,7 @@ export declare abstract class BaseRouteReuseStrategy implements RouteReuseStrate
  * ```
  * class UserToken {}
  * class Permissions {
- *   canActivate(user: UserToken, id: string): boolean {
+ *   canActivate(): boolean {
  *     return true;
  *   }
  * }
@@ -299,7 +299,7 @@ export declare abstract class BaseRouteReuseStrategy implements RouteReuseStrate
  * class AppModule {}
  * ```
  *
- * You can alternatively provide an in-line function with the `canActivate` signature:
+ * You can alternatively provide an in-line function with the `CanActivateFn` signature:
  *
  * ```
  * @NgModule({
@@ -308,16 +308,10 @@ export declare abstract class BaseRouteReuseStrategy implements RouteReuseStrate
  *       {
  *         path: 'team/:id',
  *         component: TeamComponent,
- *         canActivate: ['canActivateTeam']
+ *         canActivate: [(route: ActivatedRouteSnapshot, state: RouterStateSnapshot) => true]
  *       }
  *     ])
  *   ],
- *   providers: [
- *     {
- *       provide: 'canActivateTeam',
- *       useValue: (route: ActivatedRouteSnapshot, state: RouterStateSnapshot) => true
- *     }
- *   ]
  * })
  * class AppModule {}
  * ```
@@ -384,7 +378,7 @@ export declare interface CanActivate {
  * class AppModule {}
  * ```
  *
- * You can alternatively provide an in-line function with the `canActivateChild` signature:
+ * You can alternatively provide an in-line function with the `CanActivateChildFn` signature:
  *
  * ```
  * @NgModule({
@@ -392,7 +386,7 @@ export declare interface CanActivate {
  *     RouterModule.forRoot([
  *       {
  *         path: 'root',
- *         canActivateChild: ['canActivateTeam'],
+ *         canActivateChild: [(route: ActivatedRouteSnapshot, state: RouterStateSnapshot) => true],
  *         children: [
  *           {
  *             path: 'team/:id',
@@ -402,12 +396,6 @@ export declare interface CanActivate {
  *       }
  *     ])
  *   ],
- *   providers: [
- *     {
- *       provide: 'canActivateTeam',
- *       useValue: (route: ActivatedRouteSnapshot, state: RouterStateSnapshot) => true
- *     }
- *   ]
  * })
  * class AppModule {}
  * ```
@@ -418,6 +406,24 @@ export declare interface CanActivateChild {
     canActivateChild(childRoute: ActivatedRouteSnapshot, state: RouterStateSnapshot): Observable<boolean | UrlTree> | Promise<boolean | UrlTree> | boolean | UrlTree;
 }
 
+/**
+ * The signature of a function used as a `canActivateChild` guard on a `Route`.
+ *
+ * @publicApi
+ * @see `CanActivateChild`
+ * @see `Route`
+ */
+export declare type CanActivateChildFn = (childRoute: ActivatedRouteSnapshot, state: RouterStateSnapshot) => Observable<boolean | UrlTree> | Promise<boolean | UrlTree> | boolean | UrlTree;
+
+/**
+ * The signature of a function used as a `canActivate` guard on a `Route`.
+ *
+ * @publicApi
+ * @see `CanActivate`
+ * @see `Route`
+ */
+export declare type CanActivateFn = (route: ActivatedRouteSnapshot, state: RouterStateSnapshot) => Observable<boolean | UrlTree> | Promise<boolean | UrlTree> | boolean | UrlTree;
+
 /**
  * @description
  *
@@ -472,7 +478,7 @@ export declare interface CanActivateChild {
  * class AppModule {}
  * ```
  *
- * You can alternatively provide an in-line function with the `canDeactivate` signature:
+ * You can alternatively provide an in-line function with the `CanDeactivateFn` signature:
  *
  * ```
  * @NgModule({
@@ -481,17 +487,11 @@ export declare interface CanActivateChild {
  *       {
  *         path: 'team/:id',
  *         component: TeamComponent,
- *         canDeactivate: ['canDeactivateTeam']
+ *         canDeactivate: [(component: TeamComponent, currentRoute: ActivatedRouteSnapshot,
+ * currentState: RouterStateSnapshot, nextState: RouterStateSnapshot) => true]
  *       }
  *     ])
  *   ],
- *   providers: [
- *     {
- *       provide: 'canDeactivateTeam',
- *       useValue: (component: TeamComponent, currentRoute: ActivatedRouteSnapshot, currentState:
- * RouterStateSnapshot, nextState: RouterStateSnapshot) => true
- *     }
- *   ]
  * })
  * class AppModule {}
  * ```
@@ -502,6 +502,15 @@ export declare interface CanDeactivate<T> {
     canDeactivate(component: T, currentRoute: ActivatedRouteSnapshot, currentState: RouterStateSnapshot, nextState?: RouterStateSnapshot): Observable<boolean | UrlTree> | Promise<boolean | UrlTree> | boolean | UrlTree;
 }
 
+/**
+ * The signature of a function used as a `canDeactivate` guard on a `Route`.
+ *
+ * @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;
+
 /**
  * @description
  *
@@ -553,7 +562,7 @@ export declare interface CanDeactivate<T> {
  * class AppModule {}
  * ```
  *
- * You can alternatively provide an in-line function with the `canLoad` signature:
+ * You can alternatively provide an in-line function with the `CanLoadFn` signature:
  *
  * ```
  * @NgModule({
@@ -563,16 +572,10 @@ export declare interface CanDeactivate<T> {
  *         path: 'team/:id',
  *         component: TeamComponent,
  *         loadChildren: () => import('./team').then(mod => mod.TeamModule),
- *         canLoad: ['canLoadTeamSection']
+ *         canLoad: [(route: Route, segments: UrlSegment[]) => true]
  *       }
  *     ])
  *   ],
- *   providers: [
- *     {
- *       provide: 'canLoadTeamSection',
- *       useValue: (route: Route, segments: UrlSegment[]) => true
- *     }
- *   ]
  * })
  * class AppModule {}
  * ```
@@ -583,6 +586,15 @@ export declare interface CanLoad {
     canLoad(route: Route, segments: UrlSegment[]): Observable<boolean | UrlTree> | Promise<boolean | UrlTree> | boolean | UrlTree;
 }
 
+/**
+ * The signature of a function used as a `canLoad` guard on a `Route`.
+ *
+ * @publicApi
+ * @see `CanLoad`
+ * @see `Route`
+ */
+export declare type CanLoadFn = (route: Route, segments: UrlSegment[]) => Observable<boolean | UrlTree> | Promise<boolean | UrlTree> | boolean | UrlTree;
+
 /**
  * @description
  *
@@ -642,11 +654,9 @@ export declare interface CanLoad {
  * `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 `canMatch` signature:
+ * You can alternatively provide an in-line function with the `CanMatchFn` signature:
  *
  * ```
- * const CAN_MATCH_TEAM_SECTION = new InjectionToken('CanMatchTeamSection');
- *
  * @NgModule({
  *   imports: [
  *     RouterModule.forRoot([
@@ -654,7 +664,7 @@ export declare interface CanLoad {
  *         path: 'team/:id',
  *         component: TeamComponent,
  *         loadChildren: () => import('./team').then(mod => mod.TeamModule),
- *         canMatch: [CAN_MATCH_TEAM_SECTION]
+ *         canMatch: [(route: Route, segments: UrlSegment[]) => true]
  *       },
  *       {
  *         path: '**',
@@ -662,12 +672,6 @@ export declare interface CanLoad {
  *       }
  *     ])
  *   ],
- *   providers: [
- *     {
- *       provide: CAN_MATCH_TEAM_SECTION,
- *       useValue: (route: Route, segments: UrlSegment[]) => true
- *     }
- *   ]
  * })
  * class AppModule {}
  * ```
@@ -823,6 +827,17 @@ export declare type Data = {
     [key: string | symbol]: any;
 };
 
+/**
+ * A type alias for providers returned by `withDebugTracing` for use with `provideRouter`.
+ *
+ * @see `withDebugTracing`
+ * @see `provideRouter`
+ *
+ * @publicApi
+ * @developerPreview
+ */
+export declare type DebugTracingFeature = RouterFeature<RouterFeatureKind.DebugTracingFeature>;
+
 /**
  * The default `TitleStrategy` used by the router that updates the title using the `Title` service.
  */
@@ -893,6 +908,30 @@ export declare class DefaultUrlSerializer implements UrlSerializer {
  */
 export declare type DetachedRouteHandle = {};
 
+/**
+ * A type alias for providers returned by `withDisabledInitialNavigation` for use with
+ * `provideRouter`.
+ *
+ * @see `withDisabledInitialNavigation`
+ * @see `provideRouter`
+ *
+ * @publicApi
+ * @developerPreview
+ */
+export declare type DisabledInitialNavigationFeature = RouterFeature<RouterFeatureKind.DisabledInitialNavigationFeature>;
+
+/**
+ * A type alias for providers returned by `withEnabledBlockingInitialNavigation` for use with
+ * `provideRouter`.
+ *
+ * @see `withEnabledBlockingInitialNavigation`
+ * @see `provideRouter`
+ *
+ * @publicApi
+ * @developerPreview
+ */
+export declare type EnabledBlockingInitialNavigationFeature = RouterFeature<RouterFeatureKind.EnabledBlockingInitialNavigationFeature>;
+
 /**
  * Error handler that is invoked when a navigation error occurs.
  *
@@ -973,7 +1012,7 @@ export declare const enum EventType {
  *
  * @publicApi
  */
-export declare interface ExtraOptions {
+export declare interface ExtraOptions extends InMemoryScrollingOptions, RouterConfigOptions {
     /**
      * When true, log all internal navigation events to the console.
      * Use for debugging.
@@ -1008,57 +1047,6 @@ export declare interface ExtraOptions {
      * One of `PreloadAllModules` or `NoPreloading` (the default).
      */
     preloadingStrategy?: any;
-    /**
-     * Define what the router should do if it receives a navigation request to the current URL.
-     * Default is `ignore`, which causes the router ignores the navigation.
-     * This can disable features such as a "refresh" button.
-     * Use this option to configure the behavior when navigating to the
-     * current URL. Default is 'ignore'.
-     */
-    onSameUrlNavigation?: 'reload' | 'ignore';
-    /**
-     * Configures if the scroll position needs to be restored when navigating back.
-     *
-     * * 'disabled'- (Default) Does nothing. Scroll position is maintained on navigation.
-     * * 'top'- Sets the scroll position to x = 0, y = 0 on all navigation.
-     * * 'enabled'- Restores the previous scroll position on backward navigation, else sets the
-     * position to the anchor if one is provided, or sets the scroll position to [0, 0] (forward
-     * navigation). This option will be the default in the future.
-     *
-     * You can implement custom scroll restoration behavior by adapting the enabled behavior as
-     * in the following example.
-     *
-     * ```typescript
-     * class AppComponent {
-     *   movieData: any;
-     *
-     *   constructor(private router: Router, private viewportScroller: ViewportScroller,
-     * changeDetectorRef: ChangeDetectorRef) {
-     *   router.events.pipe(filter((event: Event): event is Scroll => event instanceof Scroll)
-     *     ).subscribe(e => {
-     *       fetch('http://example.com/movies.json').then(response => {
-     *         this.movieData = response.json();
-     *         // update the template with the data before restoring scroll
-     *         changeDetectorRef.detectChanges();
-     *
-     *         if (e.position) {
-     *           viewportScroller.scrollToPosition(e.position);
-     *         }
-     *       });
-     *     });
-     *   }
-     * }
-     * ```
-     */
-    scrollPositionRestoration?: 'disabled' | 'enabled' | 'top';
-    /**
-     * When set to 'enabled', scrolls to the anchor element when the URL has a fragment.
-     * Anchor scrolling is disabled by default.
-     *
-     * Anchor scrolling does not happen on 'popstate'. Instead, we restore the position
-     * that we stored or scroll to the top.
-     */
-    anchorScrolling?: 'disabled' | 'enabled';
     /**
      * Configures the scroll offset the router will use when scrolling to an element.
      *
@@ -1068,21 +1056,6 @@ export declare interface ExtraOptions {
      * it restores scroll position.
      */
     scrollOffset?: [number, number] | (() => [number, number]);
-    /**
-     * Defines how the router merges parameters, data, and resolved data from parent to child
-     * routes. By default ('emptyOnly'), inherits parent parameters only for
-     * path-less or component-less routes.
-     *
-     * Set to 'always' to enable unconditional inheritance of parent parameters.
-     *
-     * Note that when dealing with matrix parameters, "parent" refers to the parent `Route`
-     * config which does not necessarily mean the "URL segment to the left". When the `Route` `path`
-     * contains multiple segments, the matrix parameters must appear on the last segment. For example,
-     * matrix parameters for `{path: 'a/b', component: MyComp}` should appear as `a/b;foo=bar` and not
-     * `a;foo=bar/b`.
-     *
-     */
-    paramsInheritanceStrategy?: 'emptyOnly' | 'always';
     /**
      * A custom handler for malformed URI errors. The handler is invoked when `encodedURI` contains
      * invalid character sequences.
@@ -1094,14 +1067,6 @@ export declare interface ExtraOptions {
      * - `'url'` -  The malformed URL that caused the URIError
      * */
     malformedUriErrorHandler?: (error: URIError, urlSerializer: UrlSerializer, url: string) => UrlTree;
-    /**
-     * Defines when the router updates the browser URL. By default ('deferred'),
-     * update after successful navigation.
-     * Set to 'eager' if prefer to update the URL at the beginning of navigation.
-     * Updating the URL early allows you to handle a failure of navigation by
-     * showing an error message with the URL that failed.
-     */
-    urlUpdateStrategy?: 'deferred' | 'eager';
     /**
      * Enables a bug fix that corrects relative link resolution in components with empty paths.
      * Example:
@@ -1137,28 +1102,6 @@ export declare interface ExtraOptions {
      * @deprecated
      */
     relativeLinkResolution?: 'legacy' | 'corrected';
-    /**
-     * Configures how the Router attempts to restore state when a navigation is cancelled.
-     *
-     * 'replace' - Always uses `location.replaceState` to set the browser state to the state of the
-     * router before the navigation started. This means that if the URL of the browser is updated
-     * _before_ the navigation is canceled, the Router will simply replace the item in history rather
-     * than trying to restore to the previous location in the session history. This happens most
-     * frequently with `urlUpdateStrategy: 'eager'` and navigations with the browser back/forward
-     * buttons.
-     *
-     * 'computed' - Will attempt to return to the same index in the session history that corresponds
-     * to the Angular route when the navigation gets cancelled. For example, if the browser back
-     * button is clicked and the navigation is cancelled, the Router will trigger a forward navigation
-     * and vice versa.
-     *
-     * Note: the 'computed' option is incompatible with any `UrlHandlingStrategy` which only
-     * handles a portion of the URL because the history restoration navigates to the previous place in
-     * the browser history rather than simply resetting a portion of the URL.
-     *
-     * The default value is `replace` when not set.
-     */
-    canceledNavigationResolution?: 'replace' | 'computed';
 }
 
 /**
@@ -1263,6 +1206,83 @@ declare namespace i4 {
  */
 export declare type InitialNavigation = 'disabled' | 'enabledBlocking' | 'enabledNonBlocking';
 
+/**
+ * A type alias for providers returned by `withEnabledBlockingInitialNavigation` or
+ * `withDisabledInitialNavigation` functions for use with `provideRouter`.
+ *
+ * @see `withEnabledBlockingInitialNavigation`
+ * @see `withDisabledInitialNavigation`
+ * @see `provideRouter`
+ *
+ * @publicApi
+ * @developerPreview
+ */
+export declare type InitialNavigationFeature = EnabledBlockingInitialNavigationFeature | DisabledInitialNavigationFeature;
+
+/**
+ * A type alias for providers returned by `withInMemoryScrolling` for use with `provideRouter`.
+ *
+ * @see `withInMemoryScrolling`
+ * @see `provideRouter`
+ *
+ * @publicApi
+ * @developerPreview
+ */
+export declare type InMemoryScrollingFeature = RouterFeature<RouterFeatureKind.InMemoryScrollingFeature>;
+
+/**
+ * Configuration options for the scrolling feature which can be used with `withInMemoryScrolling`
+ * function.
+ *
+ * @publicApi
+ * @developerPreview
+ */
+export declare interface InMemoryScrollingOptions {
+    /**
+     * When set to 'enabled', scrolls to the anchor element when the URL has a fragment.
+     * Anchor scrolling is disabled by default.
+     *
+     * Anchor scrolling does not happen on 'popstate'. Instead, we restore the position
+     * that we stored or scroll to the top.
+     */
+    anchorScrolling?: 'disabled' | 'enabled';
+    /**
+     * Configures if the scroll position needs to be restored when navigating back.
+     *
+     * * 'disabled'- (Default) Does nothing. Scroll position is maintained on navigation.
+     * * 'top'- Sets the scroll position to x = 0, y = 0 on all navigation.
+     * * 'enabled'- Restores the previous scroll position on backward navigation, else sets the
+     * position to the anchor if one is provided, or sets the scroll position to [0, 0] (forward
+     * navigation). This option will be the default in the future.
+     *
+     * You can implement custom scroll restoration behavior by adapting the enabled behavior as
+     * in the following example.
+     *
+     * ```typescript
+     * class AppComponent {
+     *   movieData: any;
+     *
+     *   constructor(private router: Router, private viewportScroller: ViewportScroller,
+     * changeDetectorRef: ChangeDetectorRef) {
+     *   router.events.pipe(filter((event: Event): event is Scroll => event instanceof Scroll)
+     *     ).subscribe(e => {
+     *       fetch('http://example.com/movies.json').then(response => {
+     *         this.movieData = response.json();
+     *         // update the template with the data before restoring scroll
+     *         changeDetectorRef.detectChanges();
+     *
+     *         if (e.position) {
+     *           viewportScroller.scrollToPosition(e.position);
+     *         }
+     *       });
+     *     });
+     *   }
+     * }
+     * ```
+     */
+    scrollPositionRestoration?: 'disabled' | 'enabled' | 'top';
+}
+
 /**
  * A set of options which specify how to determine if a `UrlTree` is active, given the `UrlTree`
  * for the current router state.
@@ -1783,6 +1803,18 @@ export declare class PreloadAllModules implements PreloadingStrategy {
     static ɵprov: i0.ɵɵInjectableDeclaration<PreloadAllModules>;
 }
 
+/**
+ * A type alias that represents a feature which enables preloading in Router.
+ * The type is used to describe the return value of the `withPreloading` function.
+ *
+ * @see `withPreloading`
+ * @see `provideRouter`
+ *
+ * @publicApi
+ * @developerPreview
+ */
+export declare type PreloadingFeature = RouterFeature<RouterFeatureKind.PreloadingFeature>;
+
 /**
  * @description
  *
@@ -1801,6 +1833,45 @@ export declare abstract class PreloadingStrategy {
  */
 export declare const PRIMARY_OUTLET = "primary";
 
+/**
+ * Sets up providers necessary to enable `Router` functionality for the application.
+ * Allows to configure a set of routes as well as extra features that should be enabled.
+ *
+ * @usageNotes
+ *
+ * Basic example of how you can add a Router to your application:
+ * ```
+ * const appRoutes: Routes = [];
+ * bootstrapApplication(AppComponent, {
+ *   providers: [provideRouter(appRoutes)]
+ * });
+ * ```
+ *
+ * You can also enable optional features in the Router by adding functions from the `RouterFeatures`
+ * type:
+ * ```
+ * const appRoutes: Routes = [];
+ * bootstrapApplication(AppComponent,
+ *   {
+ *     providers: [
+ *       provideRouter(appRoutes,
+ *         withDebugTracing(),
+ *         withRouterConfig({paramsInheritanceStrategy: 'always'}))
+ *     ]
+ *   }
+ * );
+ * ```
+ *
+ * @see `RouterFeatures`
+ *
+ * @publicApi
+ * @developerPreview
+ * @param routes A set of `Route`s to use for the application routing table.
+ * @param features Optional features to configure additional router behaviors.
+ * @returns A set of providers to setup a Router.
+ */
+export declare function provideRouter(routes: Routes, ...features: RouterFeatures[]): Provider[];
+
 /**
  * Registers a [DI provider](guide/glossary#provider) for a set of routes.
  * @param routes The route configuration to provide.
@@ -1809,10 +1880,9 @@ export declare const PRIMARY_OUTLET = "primary";
  *
  * ```
  * @NgModule({
- *   imports: [RouterModule.forChild(ROUTES)],
- *   providers: [provideRoutes(EXTRA_ROUTES)]
+ *   providers: [provideRoutes(ROUTES)]
  * })
- * class MyNgModule {}
+ * class LazyLoadedChildModule {}
  * ```
  *
  * @publicApi
@@ -1880,7 +1950,7 @@ export declare type QueryParamsHandling = 'merge' | 'preserve' | '';
  * export class AppRoutingModule {}
  * ```
  *
- * You can alternatively provide an in-line function with the `resolve()` signature:
+ * You can alternatively provide an in-line function with the `ResolveFn` signature:
  *
  * ```
  * export const myHero: Hero = {
@@ -1894,17 +1964,11 @@ export declare type QueryParamsHandling = 'merge' | 'preserve' | '';
  *         path: 'detail/:id',
  *         component: HeroComponent,
  *         resolve: {
- *           hero: 'heroResolver'
+ *           hero: (route: ActivatedRouteSnapshot, state: RouterStateSnapshot) => myHero
  *         }
  *       }
  *     ])
  *   ],
- *   providers: [
- *     {
- *       provide: 'heroResolver',
- *       useValue: (route: ActivatedRouteSnapshot, state: RouterStateSnapshot) => myHero
- *     }
- *   ]
  * })
  * export class AppModule {}
  * ```
@@ -1967,7 +2031,7 @@ export declare interface Resolve<T> {
  * @publicApi
  */
 export declare type ResolveData = {
-    [key: string | symbol]: any;
+    [key: string | symbol]: any | ResolveFn<unknown>;
 };
 
 /**
@@ -1994,6 +2058,14 @@ export declare class ResolveEnd extends RouterEvent {
     toString(): string;
 }
 
+/**
+ * Function type definition for a data provider.
+ *
+ * @see `Route#resolve`.
+ * @publicApi
+ */
+export declare type ResolveFn<T> = (route: ActivatedRouteSnapshot, state: RouterStateSnapshot) => Observable<T> | Promise<T> | T;
+
 /**
  * An event triggered at the start of the Resolve phase of routing.
  *
@@ -2254,7 +2326,7 @@ export declare interface Route {
      *
      * @see `PageTitleStrategy`
      */
-    title?: string | Type<Resolve<string>>;
+    title?: string | Type<Resolve<string>> | ResolveFn<string>;
     /**
      * The path to match against. Cannot be used together with a custom `matcher` function.
      * A URL string that uses router matching notation.
@@ -2311,36 +2383,50 @@ export declare interface Route {
      */
     outlet?: string;
     /**
-     * An array of dependency-injection tokens used to look up `CanActivate()`
+     * An array of `CanActivateFn` or DI tokens used to look up `CanActivate()`
      * handlers, in order to determine if the current user is allowed to
      * activate the component. By default, any user can activate.
+     *
+     * When using a function rather than DI tokens, the function can call `inject` to get any required
+     * dependencies. This `inject` call must be done in a synchronous context.
      */
-    canActivate?: any[];
+    canActivate?: Array<CanActivateFn | any>;
     /**
-     * An array of DI tokens used to look up `CanMatch()`
+     * An array of `CanMatchFn` or DI tokens used to look up `CanMatch()`
      * handlers, in order to determine if the current user is allowed to
      * match the `Route`. By default, any route can match.
+     *
+     * When using a function rather than DI tokens, the function can call `inject` to get any required
+     * dependencies. This `inject` call must be done in a synchronous context.
      */
-    canMatch?: Array<Type<CanMatch> | InjectionToken<CanMatchFn>>;
+    canMatch?: Array<Type<CanMatch> | InjectionToken<CanMatchFn> | CanMatchFn>;
     /**
-     * An array of DI tokens used to look up `CanActivateChild()` handlers,
+     * An array of `CanActivateChildFn` or DI tokens used to look up `CanActivateChild()` handlers,
      * in order to determine if the current user is allowed to activate
      * a child of the component. By default, any user can activate a child.
+     *
+     * When using a function rather than DI tokens, the function can call `inject` to get any required
+     * dependencies. This `inject` call must be done in a synchronous context.
      */
-    canActivateChild?: any[];
+    canActivateChild?: Array<CanActivateChildFn | any>;
     /**
-     * An array of DI tokens used to look up `CanDeactivate()`
+     * An array of `CanDeactivateFn` or DI tokens used to look up `CanDeactivate()`
      * handlers, in order to determine if the current user is allowed to
      * deactivate the component. By default, any user can deactivate.
      *
+     * When using a function rather than DI tokens, the function can call `inject` to get any required
+     * dependencies. This `inject` call must be done in a synchronous context.
      */
-    canDeactivate?: any[];
+    canDeactivate?: Array<CanDeactivateFn<any> | any>;
     /**
-     * An array of DI tokens used to look up `CanLoad()`
+     * An array of `CanLoadFn` or DI tokens used to look up `CanLoad()`
      * handlers, in order to determine if the current user is allowed to
      * load the component. By default, any user can load.
+     *
+     * When using a function rather than DI tokens, the function can call `inject` to get any required
+     * dependencies. This `inject` call must be done in a synchronous context.
      */
-    canLoad?: any[];
+    canLoad?: Array<CanLoadFn | any>;
     /**
      * Additional developer-defined data provided to the component via
      * `ActivatedRoute`. By default, no additional data is passed.
@@ -2811,6 +2897,79 @@ declare class RouterConfigLoader {
     static ɵprov: i0.ɵɵInjectableDeclaration<RouterConfigLoader>;
 }
 
+/**
+ * Extra configuration options that can be used with the `withRouterConfig` function.
+ *
+ * @publicApi
+ * @developerPreview
+ */
+export declare interface RouterConfigOptions {
+    /**
+     * Configures how the Router attempts to restore state when a navigation is cancelled.
+     *
+     * 'replace' - Always uses `location.replaceState` to set the browser state to the state of the
+     * router before the navigation started. This means that if the URL of the browser is updated
+     * _before_ the navigation is canceled, the Router will simply replace the item in history rather
+     * than trying to restore to the previous location in the session history. This happens most
+     * frequently with `urlUpdateStrategy: 'eager'` and navigations with the browser back/forward
+     * buttons.
+     *
+     * 'computed' - Will attempt to return to the same index in the session history that corresponds
+     * to the Angular route when the navigation gets cancelled. For example, if the browser back
+     * button is clicked and the navigation is cancelled, the Router will trigger a forward navigation
+     * and vice versa.
+     *
+     * Note: the 'computed' option is incompatible with any `UrlHandlingStrategy` which only
+     * handles a portion of the URL because the history restoration navigates to the previous place in
+     * the browser history rather than simply resetting a portion of the URL.
+     *
+     * The default value is `replace` when not set.
+     */
+    canceledNavigationResolution?: 'replace' | 'computed';
+    /**
+     * Define what the router should do if it receives a navigation request to the current URL.
+     * Default is `ignore`, which causes the router ignores the navigation.
+     * This can disable features such as a "refresh" button.
+     * Use this option to configure the behavior when navigating to the
+     * current URL. Default is 'ignore'.
+     */
+    onSameUrlNavigation?: 'reload' | 'ignore';
+    /**
+     * Defines how the router merges parameters, data, and resolved data from parent to child
+     * routes. By default ('emptyOnly'), inherits parent parameters only for
+     * path-less or component-less routes.
+     *
+     * Set to 'always' to enable unconditional inheritance of parent parameters.
+     *
+     * Note that when dealing with matrix parameters, "parent" refers to the parent `Route`
+     * config which does not necessarily mean the "URL segment to the left". When the `Route` `path`
+     * contains multiple segments, the matrix parameters must appear on the last segment. For example,
+     * matrix parameters for `{path: 'a/b', component: MyComp}` should appear as `a/b;foo=bar` and not
+     * `a;foo=bar/b`.
+     *
+     */
+    paramsInheritanceStrategy?: 'emptyOnly' | 'always';
+    /**
+     * Defines when the router updates the browser URL. By default ('deferred'),
+     * update after successful navigation.
+     * Set to 'eager' if prefer to update the URL at the beginning of navigation.
+     * Updating the URL early allows you to handle a failure of navigation by
+     * showing an error message with the URL that failed.
+     */
+    urlUpdateStrategy?: 'deferred' | 'eager';
+}
+
+/**
+ * A type alias for providers returned by `withRouterConfig` for use with `provideRouter`.
+ *
+ * @see `withRouterConfig`
+ * @see `provideRouter`
+ *
+ * @publicApi
+ * @developerPreview
+ */
+export declare type RouterConfigurationFeature = RouterFeature<RouterFeatureKind.RouterConfigurationFeature>;
+
 /**
  * @description
  *
@@ -2871,6 +3030,42 @@ export declare class RouterEvent {
     url: string);
 }
 
+/**
+ * Helper type to represent a Router feature.
+ *
+ * @publicApi
+ * @developerPreview
+ */
+export declare interface RouterFeature<FeatureKind extends RouterFeatureKind> {
+    ɵkind: FeatureKind;
+    ɵproviders: Provider[];
+}
+
+/**
+ * The list of features as an enum to uniquely type each feature.
+ */
+declare const enum RouterFeatureKind {
+    PreloadingFeature = 0,
+    DebugTracingFeature = 1,
+    EnabledBlockingInitialNavigationFeature = 2,
+    DisabledInitialNavigationFeature = 3,
+    InMemoryScrollingFeature = 4,
+    RouterConfigurationFeature = 5
+}
+
+/**
+ * A type alias that represents all Router features available for use with `provideRouter`.
+ * Features can be enabled by adding special functions to the `provideRouter` call.
+ * See documentation for each symbol to find corresponding function name. See also `provideRouter`
+ * documentation on how to use those functions.
+ *
+ * @see `provideRouter`
+ *
+ * @publicApi
+ * @developerPreview
+ */
+export declare type RouterFeatures = PreloadingFeature | DebugTracingFeature | InitialNavigationFeature | InMemoryScrollingFeature | RouterConfigurationFeature;
+
 /**
  * @description
  *
@@ -2974,6 +3169,9 @@ export declare class RouterLink implements OnChanges {
     private readonly tabIndexAttribute;
     private readonly renderer;
     private readonly el;
+    private _preserveFragment;
+    private _skipLocationChange;
+    private _replaceUrl;
     /**
      * Passed to {@link Router#createUrlTree Router#createUrlTree} as part of the
      * `UrlCreationOptions`.
@@ -2995,27 +3193,6 @@ export declare class RouterLink implements OnChanges {
      * @see {@link Router#createUrlTree Router#createUrlTree}
      */
     queryParamsHandling?: QueryParamsHandling | null;
-    /**
-     * Passed to {@link Router#createUrlTree Router#createUrlTree} as part of the
-     * `UrlCreationOptions`.
-     * @see {@link UrlCreationOptions#preserveFragment UrlCreationOptions#preserveFragment}
-     * @see {@link Router#createUrlTree Router#createUrlTree}
-     */
-    preserveFragment: boolean;
-    /**
-     * Passed to {@link Router#navigateByUrl Router#navigateByUrl} as part of the
-     * `NavigationBehaviorOptions`.
-     * @see {@link NavigationBehaviorOptions#skipLocationChange NavigationBehaviorOptions#skipLocationChange}
-     * @see {@link Router#navigateByUrl Router#navigateByUrl}
-     */
-    skipLocationChange: boolean;
-    /**
-     * Passed to {@link Router#navigateByUrl Router#navigateByUrl} as part of the
-     * `NavigationBehaviorOptions`.
-     * @see {@link NavigationBehaviorOptions#replaceUrl NavigationBehaviorOptions#replaceUrl}
-     * @see {@link Router#navigateByUrl Router#navigateByUrl}
-     */
-    replaceUrl: boolean;
     /**
      * Passed to {@link Router#navigateByUrl Router#navigateByUrl} as part of the
      * `NavigationBehaviorOptions`.
@@ -3037,6 +3214,30 @@ export declare class RouterLink implements OnChanges {
     relativeTo?: ActivatedRoute | null;
     private commands;
     constructor(router: Router, route: ActivatedRoute, tabIndexAttribute: string | null | undefined, renderer: Renderer2, el: ElementRef);
+    /**
+     * Passed to {@link Router#createUrlTree Router#createUrlTree} as part of the
+     * `UrlCreationOptions`.
+     * @see {@link UrlCreationOptions#preserveFragment UrlCreationOptions#preserveFragment}
+     * @see {@link Router#createUrlTree Router#createUrlTree}
+     */
+    set preserveFragment(preserveFragment: boolean | string | null | undefined);
+    get preserveFragment(): boolean;
+    /**
+     * Passed to {@link Router#navigateByUrl Router#navigateByUrl} as part of the
+     * `NavigationBehaviorOptions`.
+     * @see {@link NavigationBehaviorOptions#skipLocationChange NavigationBehaviorOptions#skipLocationChange}
+     * @see {@link Router#navigateByUrl Router#navigateByUrl}
+     */
+    set skipLocationChange(skipLocationChange: boolean | string | null | undefined);
+    get skipLocationChange(): boolean;
+    /**
+     * Passed to {@link Router#navigateByUrl Router#navigateByUrl} as part of the
+     * `NavigationBehaviorOptions`.
+     * @see {@link NavigationBehaviorOptions#replaceUrl NavigationBehaviorOptions#replaceUrl}
+     * @see {@link Router#navigateByUrl Router#navigateByUrl}
+     */
+    set replaceUrl(replaceUrl: boolean | string | null | undefined);
+    get replaceUrl(): boolean;
     /**
      * Modifies the tab index if there was not a tabindex attribute on the element during
      * instantiation.
@@ -3056,7 +3257,7 @@ export declare class RouterLink implements OnChanges {
     onClick(): boolean;
     get urlTree(): UrlTree | null;
     static ɵfac: i0.ɵɵFactoryDeclaration<RouterLink, [null, null, { attribute: "tabindex"; }, null, null]>;
-    static ɵdir: i0.ɵɵDirectiveDeclaration<RouterLink, ":not(a):not(area)[routerLink]", never, { "queryParams": "queryParams"; "fragment": "fragment"; "queryParamsHandling": "queryParamsHandling"; "preserveFragment": "preserveFragment"; "skipLocationChange": "skipLocationChange"; "replaceUrl": "replaceUrl"; "state": "state"; "relativeTo": "relativeTo"; "routerLink": "routerLink"; }, {}, never, never, true>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<RouterLink, ":not(a):not(area)[routerLink]", never, { "queryParams": "queryParams"; "fragment": "fragment"; "queryParamsHandling": "queryParamsHandling"; "state": "state"; "relativeTo": "relativeTo"; "preserveFragment": "preserveFragment"; "skipLocationChange": "skipLocationChange"; "replaceUrl": "replaceUrl"; "routerLink": "routerLink"; }, {}, never, never, true>;
 }
 
 /**
@@ -3207,6 +3408,9 @@ export declare class RouterLinkWithHref implements OnChanges, OnDestroy {
     private router;
     private route;
     private locationStrategy;
+    private _preserveFragment;
+    private _skipLocationChange;
+    private _replaceUrl;
     target: string;
     /**
      * Passed to {@link Router#createUrlTree Router#createUrlTree} as part of the
@@ -3229,27 +3433,6 @@ export declare class RouterLinkWithHref implements OnChanges, OnDestroy {
      * @see {@link Router#createUrlTree Router#createUrlTree}
      */
     queryParamsHandling?: QueryParamsHandling | null;
-    /**
-     * Passed to {@link Router#createUrlTree Router#createUrlTree} as part of the
-     * `UrlCreationOptions`.
-     * @see {@link UrlCreationOptions#preserveFragment UrlCreationOptions#preserveFragment}
-     * @see {@link Router#createUrlTree Router#createUrlTree}
-     */
-    preserveFragment: boolean;
-    /**
-     * Passed to {@link Router#navigateByUrl Router#navigateByUrl} as part of the
-     * `NavigationBehaviorOptions`.
-     * @see {@link NavigationBehaviorOptions#skipLocationChange NavigationBehaviorOptions#skipLocationChange}
-     * @see {@link Router#navigateByUrl Router#navigateByUrl}
-     */
-    skipLocationChange: boolean;
-    /**
-     * Passed to {@link Router#navigateByUrl Router#navigateByUrl} as part of the
-     * `NavigationBehaviorOptions`.
-     * @see {@link NavigationBehaviorOptions#replaceUrl NavigationBehaviorOptions#replaceUrl}
-     * @see {@link Router#navigateByUrl Router#navigateByUrl}
-     */
-    replaceUrl: boolean;
     /**
      * Passed to {@link Router#navigateByUrl Router#navigateByUrl} as part of the
      * `NavigationBehaviorOptions`.
@@ -3273,6 +3456,30 @@ export declare class RouterLinkWithHref implements OnChanges, OnDestroy {
     private subscription;
     href: string | null;
     constructor(router: Router, route: ActivatedRoute, locationStrategy: LocationStrategy);
+    /**
+     * Passed to {@link Router#createUrlTree Router#createUrlTree} as part of the
+     * `UrlCreationOptions`.
+     * @see {@link UrlCreationOptions#preserveFragment UrlCreationOptions#preserveFragment}
+     * @see {@link Router#createUrlTree Router#createUrlTree}
+     */
+    set preserveFragment(preserveFragment: boolean | string | null | undefined);
+    get preserveFragment(): boolean;
+    /**
+     * Passed to {@link Router#navigateByUrl Router#navigateByUrl} as part of the
+     * `NavigationBehaviorOptions`.
+     * @see {@link NavigationBehaviorOptions#skipLocationChange NavigationBehaviorOptions#skipLocationChange}
+     * @see {@link Router#navigateByUrl Router#navigateByUrl}
+     */
+    set skipLocationChange(skipLocationChange: boolean | string | null | undefined);
+    get skipLocationChange(): boolean;
+    /**
+     * Passed to {@link Router#navigateByUrl Router#navigateByUrl} as part of the
+     * `NavigationBehaviorOptions`.
+     * @see {@link NavigationBehaviorOptions#replaceUrl NavigationBehaviorOptions#replaceUrl}
+     * @see {@link Router#navigateByUrl Router#navigateByUrl}
+     */
+    set replaceUrl(replaceUrl: boolean | string | null | undefined);
+    get replaceUrl(): boolean;
     /**
      * Commands to pass to {@link Router#createUrlTree Router#createUrlTree}.
      *   - **array**: commands to pass to {@link Router#createUrlTree Router#createUrlTree}.
@@ -3290,7 +3497,7 @@ export declare class RouterLinkWithHref implements OnChanges, OnDestroy {
     private updateTargetUrlAndHref;
     get urlTree(): UrlTree | null;
     static ɵfac: i0.ɵɵFactoryDeclaration<RouterLinkWithHref, never>;
-    static ɵdir: i0.ɵɵDirectiveDeclaration<RouterLinkWithHref, "a[routerLink],area[routerLink]", never, { "target": "target"; "queryParams": "queryParams"; "fragment": "fragment"; "queryParamsHandling": "queryParamsHandling"; "preserveFragment": "preserveFragment"; "skipLocationChange": "skipLocationChange"; "replaceUrl": "replaceUrl"; "state": "state"; "relativeTo": "relativeTo"; "routerLink": "routerLink"; }, {}, never, never, true>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<RouterLinkWithHref, "a[routerLink],area[routerLink]", never, { "target": "target"; "queryParams": "queryParams"; "fragment": "fragment"; "queryParamsHandling": "queryParamsHandling"; "state": "state"; "relativeTo": "relativeTo"; "preserveFragment": "preserveFragment"; "skipLocationChange": "skipLocationChange"; "replaceUrl": "replaceUrl"; "routerLink": "routerLink"; }, {}, never, never, true>;
 }
 
 /**
@@ -4094,6 +4301,179 @@ export declare class UrlTree {
  */
 export declare const VERSION: Version;
 
+/**
+ * Enables logging of all internal navigation events to the console.
+ * Extra logging might be useful for debugging purposes to inspect Router event sequence.
+ *
+ * @usageNotes
+ *
+ * Basic example of how you can enable debug tracing:
+ * ```
+ * const appRoutes: Routes = [];
+ * bootstrapApplication(AppComponent,
+ *   {
+ *     providers: [
+ *       provideRouter(appRoutes, withDebugTracing())
+ *     ]
+ *   }
+ * );
+ * ```
+ *
+ * @see `provideRouter`
+ *
+ * @returns A set of providers for use with `provideRouter`.
+ *
+ * @publicApi
+ * @developerPreview
+ */
+export declare function withDebugTracing(): DebugTracingFeature;
+
+/**
+ * Disables initial navigation.
+ *
+ * Use if there is a reason to have more control over when the router starts its initial navigation
+ * due to some complex initialization logic.
+ *
+ * @usageNotes
+ *
+ * Basic example of how you can disable initial navigation:
+ * ```
+ * const appRoutes: Routes = [];
+ * bootstrapApplication(AppComponent,
+ *   {
+ *     providers: [
+ *       provideRouter(appRoutes, withDisabledInitialNavigation())
+ *     ]
+ *   }
+ * );
+ * ```
+ *
+ * @see `provideRouter`
+ *
+ * @returns A set of providers for use with `provideRouter`.
+ *
+ * @publicApi
+ * @developerPreview
+ */
+export declare function withDisabledInitialNavigation(): DisabledInitialNavigationFeature;
+
+/**
+ * Configures initial navigation to start before the root component is created.
+ *
+ * The bootstrap is blocked until the initial navigation is complete. This value is required for
+ * [server-side rendering](guide/universal) to work.
+ *
+ * @usageNotes
+ *
+ * Basic example of how you can enable this navigation behavior:
+ * ```
+ * const appRoutes: Routes = [];
+ * bootstrapApplication(AppComponent,
+ *   {
+ *     providers: [
+ *       provideRouter(appRoutes, withEnabledBlockingInitialNavigation())
+ *     ]
+ *   }
+ * );
+ * ```
+ *
+ * @see `provideRouter`
+ *
+ * @publicApi
+ * @developerPreview
+ * @returns A set of providers for use with `provideRouter`.
+ */
+export declare function withEnabledBlockingInitialNavigation(): EnabledBlockingInitialNavigationFeature;
+
+/**
+ * Enables customizable scrolling behavior for router navigations.
+ *
+ * @usageNotes
+ *
+ * Basic example of how you can enable scrolling feature:
+ * ```
+ * const appRoutes: Routes = [];
+ * bootstrapApplication(AppComponent,
+ *   {
+ *     providers: [
+ *       provideRouter(appRoutes, withInMemoryScrolling())
+ *     ]
+ *   }
+ * );
+ * ```
+ *
+ * @see `provideRouter`
+ * @see `ViewportScroller`
+ *
+ * @publicApi
+ * @developerPreview
+ * @param options Set of configuration parameters to customize scrolling behavior, see
+ *     `InMemoryScrollingOptions` for additional information.
+ * @returns A set of providers for use with `provideRouter`.
+ */
+export declare function withInMemoryScrolling(options?: InMemoryScrollingOptions): InMemoryScrollingFeature;
+
+/**
+ * Allows to configure a preloading strategy to use. The strategy is configured by providing a
+ * reference to a class that implements a `PreloadingStrategy`.
+ *
+ * @usageNotes
+ *
+ * Basic example of how you can configure preloading:
+ * ```
+ * const appRoutes: Routes = [];
+ * bootstrapApplication(AppComponent,
+ *   {
+ *     providers: [
+ *       provideRouter(appRoutes, withPreloading(PreloadAllModules))
+ *     ]
+ *   }
+ * );
+ * ```
+ *
+ * @see `provideRouter`
+ *
+ * @param preloadingStrategy A reference to a class that implements a `PreloadingStrategy` that
+ *     should be used.
+ * @returns A set of providers for use with `provideRouter`.
+ *
+ * @publicApi
+ * @developerPreview
+ */
+declare function withPreloading(preloadingStrategy: Type<PreloadingStrategy>): PreloadingFeature;
+export { withPreloading }
+export { withPreloading as ɵwithPreloading }
+
+/**
+ * Allows to provide extra parameters to configure Router.
+ *
+ * @usageNotes
+ *
+ * Basic example of how you can provide extra configuration options:
+ * ```
+ * const appRoutes: Routes = [];
+ * bootstrapApplication(AppComponent,
+ *   {
+ *     providers: [
+ *       provideRouter(appRoutes, withRouterConfig({
+ *          onSameUrlNavigation: 'reload'
+ *       }))
+ *     ]
+ *   }
+ * );
+ * ```
+ *
+ * @see `provideRouter`
+ *
+ * @param options A set of parameters to configure Router, see `RouterConfigOptions` for
+ *     additional information.
+ * @returns A set of providers for use with `provideRouter`.
+ *
+ * @publicApi
+ * @developerPreview
+ */
+export declare function withRouterConfig(options: RouterConfigOptions): RouterConfigurationFeature;
+
 export declare function ɵassignExtraOptionsToRouter(opts: ExtraOptions, router: Router): void;
 
 /**
@@ -4115,8 +4495,6 @@ export declare class ɵEmptyOutletComponent {
  */
 export declare function ɵflatten<T>(arr: T[][]): T[];
 
-export declare function ɵprovidePreloading(preloadingStrategy: Type<PreloadingStrategy>): Provider[];
-
 export declare type ɵRestoredState = {
     [k: string]: any;
     navigationId: number;