@angular/router 15.1.0-next.0 → 15.1.0-next.1

package/fesm2020/testing.mjs

@@ -1,5 +1,5 @@
 /**
- * @license Angular v15.1.0-next.0
+ * @license Angular v15.1.0-next.1
  * (c) 2010-2022 Google LLC. https://angular.io/
  * License: MIT
  */
@@ -87,16 +87,16 @@ class RouterTestingModule {
         };
     }
 }
-RouterTestingModule.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "15.1.0-next.0", ngImport: i0, type: RouterTestingModule, deps: [], target: i0.ɵɵFactoryTarget.NgModule });
-RouterTestingModule.ɵmod = i0.ɵɵngDeclareNgModule({ minVersion: "14.0.0", version: "15.1.0-next.0", ngImport: i0, type: RouterTestingModule, exports: [RouterModule] });
-RouterTestingModule.ɵinj = i0.ɵɵngDeclareInjector({ minVersion: "12.0.0", version: "15.1.0-next.0", ngImport: i0, type: RouterTestingModule, providers: [
+RouterTestingModule.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "15.1.0-next.1", ngImport: i0, type: RouterTestingModule, deps: [], target: i0.ɵɵFactoryTarget.NgModule });
+RouterTestingModule.ɵmod = i0.ɵɵngDeclareNgModule({ minVersion: "14.0.0", version: "15.1.0-next.1", ngImport: i0, type: RouterTestingModule, exports: [RouterModule] });
+RouterTestingModule.ɵinj = i0.ɵɵngDeclareInjector({ minVersion: "12.0.0", version: "15.1.0-next.1", ngImport: i0, type: RouterTestingModule, providers: [
         ɵROUTER_PROVIDERS,
         EXTRA_ROUTER_TESTING_PROVIDERS,
         provideLocationMocks(),
         ɵwithPreloading(NoPreloading).ɵproviders,
         { provide: ROUTES, multi: true, useValue: [] },
     ], imports: [RouterModule] });
-i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "15.1.0-next.0", ngImport: i0, type: RouterTestingModule, decorators: [{
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "15.1.0-next.1", ngImport: i0, type: RouterTestingModule, decorators: [{
             type: NgModule,
             args: [{
                     exports: [RouterModule],

package/fesm2020/upgrade.mjs

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

package/index.d.ts

@@ -1,5 +1,5 @@
 /**
- * @license Angular v15.1.0-next.0
+ * @license Angular v15.1.0-next.1
  * (c) 2010-2022 Google LLC. https://angular.io/
  * License: MIT
  */
@@ -580,6 +580,7 @@ export declare type CanDeactivateFn<T> = (component: T, currentRoute: ActivatedR
  * ```
  *
  * @publicApi
+ * @deprecated Use `CanMatch` instead
  */
 export declare interface CanLoad {
     canLoad(route: Route, segments: UrlSegment[]): Observable<boolean | UrlTree> | Promise<boolean | UrlTree> | boolean | UrlTree;
@@ -591,6 +592,8 @@ export declare interface CanLoad {
  * @publicApi
  * @see `CanLoad`
  * @see `Route`
+ * @see `CanMatchFn`
+ * @deprecated Use `Route.canMatch` and `CanMatchFn` instead
  */
 export declare type CanLoadFn = (route: Route, segments: UrlSegment[]) => Observable<boolean | UrlTree> | Promise<boolean | UrlTree> | boolean | UrlTree;
 
@@ -1313,7 +1316,7 @@ export declare interface IsActiveMatchOptions {
  * @see `LoadChildrenCallback`
  * @publicApi
  */
-export declare type LoadChildren = LoadChildrenCallback | ɵDeprecatedLoadChildren;
+export declare type LoadChildren = LoadChildrenCallback;
 
 /**
  *
@@ -1435,6 +1438,16 @@ export declare interface Navigation {
  * @publicApi
  */
 export declare interface NavigationBehaviorOptions {
+    /**
+     * How to handle a navigation request to the current URL.
+     *
+     * This value is a subset of the options available in `OnSameUrlNavigation` and
+     * will take precedence over the default value set for the `Router`.
+     *
+     * @see `OnSameUrlNavigation`
+     * @see `RouterConfigOptions`
+     */
+    onSameUrlNavigation?: Extract<OnSameUrlNavigation, 'reload'>;
     /**
      * When true, navigates without pushing a new state into history.
      *
@@ -1761,6 +1774,32 @@ export declare class NoPreloading implements PreloadingStrategy {
     static ɵprov: i0.ɵɵInjectableDeclaration<NoPreloading>;
 }
 
+/**
+ * How to handle a navigation request to the current URL. One of:
+ *
+ * - `'ignore'` :  The router ignores the request it is the same as the current state.
+ * - `'reload'` : The router processes the URL even if it is not different from the current state.
+ * One example of when you might want this option is if a `canMatch` guard depends on
+ * application state and initially rejects navigation to a route. After fixing the state, you want
+ * to re-navigate to the same URL so the route with the `canMatch` guard can activate.
+ *
+ * Note that this only configures whether the Route reprocesses the URL and triggers related
+ * action and events like redirects, guards, and resolvers. By default, the router re-uses a
+ * component instance when it re-navigates to the same component type without visiting a different
+ * component first. This behavior is configured by the `RouteReuseStrategy`. In order to reload
+ * routed components on same url navigation, you need to set `onSameUrlNavigation` to `'reload'`
+ * _and_ provide a `RouteReuseStrategy` which returns `false` for `shouldReuseRoute`. Additionally,
+ * resolvers and most guards for routes do not run unless the path or path params changed
+ * (configured by `runGuardsAndResolvers`).
+ *
+ * @publicApi
+ * @see RouteReuseStrategy
+ * @see RunGuardsAndResolvers
+ * @see NavigationBehaviorOptions
+ * @see RouterConfigOptions
+ */
+export declare type OnSameUrlNavigation = 'reload' | 'ignore';
+
 /**
  * Store contextual information about a `RouterOutlet`
  *
@@ -2466,6 +2505,7 @@ export declare interface Route {
      *
      * 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.
+     * @deprecated Use `canMatch` instead
      */
     canLoad?: Array<CanLoadFn | any>;
     /**
@@ -2487,11 +2527,19 @@ export declare interface Route {
      */
     loadChildren?: LoadChildren;
     /**
-     * Defines when guards and resolvers will be run. One of
-     * - `paramsOrQueryParamsChange` : Run when query parameters change.
+     * A policy for when to run guards and resolvers on a route.
+     *
+     * Guards and/or resolvers will always run when a route is activated or deactivated. When a route
+     * is unchanged, the default behavior is the same as `paramsChange`.
+     *
+     * `paramsChange` : Rerun the guards and resolvers when path or
+     * path param changes. This does not include query parameters. This option is the default.
      * - `always` : Run on every execution.
-     * By default, guards and resolvers run only when the matrix
-     * parameters of the route change.
+     * - `pathParamsChange` : Rerun guards and resolvers when the path params
+     * change. This does not compare matrix or query parameters.
+     * - `paramsOrQueryParamsChange` : Run when path, matrix, or query parameters change.
+     * - `pathParamsOrQueryParamsChange` : Rerun guards and resolvers when the path params
+     * change or query params have changed. This does not include matrix parameters.
      *
      * @see RunGuardsAndResolvers
      */
@@ -2554,10 +2602,13 @@ export declare class RouteConfigLoadStart {
  * @publicApi
  */
 export declare class Router {
+    private readonly urlSerializer;
+    private readonly rootContexts;
+    private readonly location;
     config: Routes;
-    private navigations;
     private disposed;
     private locationSubscription?;
+    private get navigationId();
     /**
      * The id of the currently active page in the router.
      * Updated to the transition's target id on a successful navigation.
@@ -2576,9 +2627,9 @@ export declare class Router {
     private console;
     private isNgZoneEnabled;
     /**
-     * An event stream for routing events in this NgModule.
+     * An event stream for routing events.
      */
-    readonly events: Observable<Event_2>;
+    get events(): Observable<Event_2>;
     /**
      * The current state of routing in this NgModule.
      */
@@ -2629,24 +2680,15 @@ export declare class Router {
      */
     titleStrategy?: TitleStrategy;
     /**
-     * How to handle a navigation request to the current URL. One of:
+     * How to handle a navigation request to the current URL.
      *
-     * - `'ignore'` :  The router ignores the request.
-     * - `'reload'` : The router reloads the URL. Use to implement a "refresh" feature.
-     *
-     * Note that this only configures whether the Route reprocesses the URL and triggers related
-     * action and events like redirects, guards, and resolvers. By default, the router re-uses a
-     * component instance when it re-navigates to the same component type without visiting a different
-     * component first. This behavior is configured by the `RouteReuseStrategy`. In order to reload
-     * routed components on same url navigation, you need to set `onSameUrlNavigation` to `'reload'`
-     * _and_ provide a `RouteReuseStrategy` which returns `false` for `shouldReuseRoute`.
      *
      * @deprecated Configure this through `provideRouter` or `RouterModule.forRoot` instead.
      * @see `withRouterConfig`
      * @see `provideRouter`
      * @see `RouterModule`
      */
-    onSameUrlNavigation: 'reload' | 'ignore';
+    onSameUrlNavigation: OnSameUrlNavigation;
     /**
      * How to merge parameters, data, resolved data, and title from parent to child
      * routes. One of:
@@ -2708,14 +2750,7 @@ export declare class Router {
      */
     constructor(
     /** @internal */
-    rootComponentType: Type<any> | null, 
-    /** @internal */
-    urlSerializer: UrlSerializer, 
-    /** @internal */
-    rootContexts: ChildrenOutletContexts, 
-    /** @internal */
-    location: Location_2, injector: Injector, compiler: Compiler, config: Routes);
-    private setTransition;
+    rootComponentType: Type<any> | null, urlSerializer: UrlSerializer, rootContexts: ChildrenOutletContexts, location: Location_2, injector: Injector, compiler: Compiler, config: Routes);
     /**
      * Sets up the location change listener and performs the initial navigation.
      */
@@ -2880,7 +2915,6 @@ export declare class Router {
      */
     isActive(url: string | UrlTree, matchOptions: IsActiveMatchOptions): boolean;
     private removeEmptyProps;
-    private processNavigations;
     private resetState;
     private resetUrlToCurrentUrlTree;
     private generateNgRouterState;
@@ -2947,13 +2981,13 @@ export declare interface RouterConfigOptions {
      */
     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'.
+     * Configures the default for handling a navigation request to the current URL.
+     *
+     * If unset, the `Router` will use `'ignore'`.
+     *
+     * @see `OnSameUrlNavigation`
      */
-    onSameUrlNavigation?: 'reload' | 'ignore';
+    onSameUrlNavigation?: OnSameUrlNavigation;
     /**
      * Defines how the router merges parameters, data, and resolved data from parent to child
      * routes. By default ('emptyOnly'), inherits parent parameters only for
@@ -3964,7 +3998,7 @@ export declare interface UrlCreationOptions {
      *    constructor(private router: Router, private route: ActivatedRoute) {}
      *
      *    go() {
-     *      this.router.navigate(['../list'], { relativeTo: this.route });
+     *      router.navigate(['../list'], { relativeTo: this.route });
      *    }
      *  }
      * ```
@@ -3978,7 +4012,7 @@ export declare interface UrlCreationOptions {
      *
      * ```
      * // Navigate to /results?page=1
-     * this.router.navigate(['/results'], { queryParams: { page: 1 } });
+     * router.navigate(['/results'], { queryParams: { page: 1 } });
      * ```
      */
     queryParams?: Params | null;
@@ -3987,7 +4021,7 @@ export declare interface UrlCreationOptions {
      *
      * ```
      * // Navigate to /results#top
-     * this.router.navigate(['/results'], { fragment: 'top' });
+     * router.navigate(['/results'], { fragment: 'top' });
      * ```
      */
     fragment?: string;
@@ -4000,13 +4034,13 @@ export declare interface UrlCreationOptions {
      * The "preserve" option discards any new query params:
      * ```
      * // from /view1?page=1 to/view2?page=1
-     * this.router.navigate(['/view2'], { queryParams: { page: 2 },  queryParamsHandling: "preserve"
+     * router.navigate(['/view2'], { queryParams: { page: 2 },  queryParamsHandling: "preserve"
      * });
      * ```
      * The "merge" option appends new query params to the params from the current URL:
      * ```
      * // from /view1?page=1 to/view2?page=1&otherKey=2
-     * this.router.navigate(['/view2'], { queryParams: { otherKey: 2 },  queryParamsHandling: "merge"
+     * router.navigate(['/view2'], { queryParams: { otherKey: 2 },  queryParamsHandling: "merge"
      * });
      * ```
      * In case of a key collision between current parameters and those in the `queryParams` object,
@@ -4019,7 +4053,7 @@ export declare interface UrlCreationOptions {
      *
      * ```
      * // Preserve fragment from /results#top to /view#top
-     * this.router.navigate(['/view'], { preserveFragment: true });
+     * router.navigate(['/view'], { preserveFragment: true });
      * ```
      */
     preserveFragment?: boolean;
@@ -4417,14 +4451,6 @@ export declare function withRouterConfig(options: RouterConfigOptions): RouterCo
 
 export declare function ɵassignExtraOptionsToRouter(opts: ExtraOptions, router: Router): void;
 
-/**
- * Deprecated `loadChildren` value types.
- *
- * @publicApi
- * @deprecated represents the deprecated type side of `LoadChildren`.
- */
-export declare type ɵDeprecatedLoadChildren = never;
-
 /**
  * This component is used internally within the router to be a placeholder when an empty
  * router-outlet is needed. For example, with a config such as:

package/package.json

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

package/testing/index.d.ts

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

package/upgrade/index.d.ts

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