@angular/router 7.2.0-beta.0 → 7.2.0

package/fesm2015/router.js

@@ -1,5 +1,5 @@
 /**
- * @license Angular v7.2.0-beta.0
+ * @license Angular v7.2.0
  * (c) 2010-2018 Google, Inc. https://angular.io/
  * License: MIT
  */
@@ -12,7 +12,14 @@ import { ɵgetDOM } from '@angular/platform-browser';
 
 /**
  * @fileoverview added by tsickle
- * @suppress {checkTypes,extraRequire,uselessCode} checked by tsc
+ * @suppress {checkTypes,extraRequire,missingReturn,unusedPrivateMembers,uselessCode} checked by tsc
+ */
+/**
+ * @license
+ * Copyright Google Inc. All Rights Reserved.
+ *
+ * Use of this source code is governed by an MIT-style license that can be
+ * found in the LICENSE file at https://angular.io/license
  */
 /**
  * \@description
@@ -60,10 +67,14 @@ class NavigationStart extends RouterEvent {
      * @param {?=} navigationTrigger
      * @param {?=} restoredState
      */
-    constructor(/** @docsNotRequired */
-    id, /** @docsNotRequired */
-    url, /** @docsNotRequired */
-    navigationTrigger = 'imperative', /** @docsNotRequired */
+    constructor(
+    /** @docsNotRequired */
+    id, 
+    /** @docsNotRequired */
+    url, 
+    /** @docsNotRequired */
+    navigationTrigger = 'imperative', 
+    /** @docsNotRequired */
     restoredState = null) {
         super(id, url);
         this.navigationTrigger = navigationTrigger;
@@ -88,8 +99,10 @@ class NavigationEnd extends RouterEvent {
      * @param {?} url
      * @param {?} urlAfterRedirects
      */
-    constructor(/** @docsNotRequired */
-    id, /** @docsNotRequired */
+    constructor(
+    /** @docsNotRequired */
+    id, 
+    /** @docsNotRequired */
     url, urlAfterRedirects) {
         super(id, url);
         this.urlAfterRedirects = urlAfterRedirects;
@@ -115,8 +128,10 @@ class NavigationCancel extends RouterEvent {
      * @param {?} url
      * @param {?} reason
      */
-    constructor(/** @docsNotRequired */
-    id, /** @docsNotRequired */
+    constructor(
+    /** @docsNotRequired */
+    id, 
+    /** @docsNotRequired */
     url, reason) {
         super(id, url);
         this.reason = reason;
@@ -140,8 +155,10 @@ class NavigationError extends RouterEvent {
      * @param {?} url
      * @param {?} error
      */
-    constructor(/** @docsNotRequired */
-    id, /** @docsNotRequired */
+    constructor(
+    /** @docsNotRequired */
+    id, 
+    /** @docsNotRequired */
     url, error) {
         super(id, url);
         this.error = error;
@@ -168,8 +185,10 @@ class RoutesRecognized extends RouterEvent {
      * @param {?} urlAfterRedirects
      * @param {?} state
      */
-    constructor(/** @docsNotRequired */
-    id, /** @docsNotRequired */
+    constructor(
+    /** @docsNotRequired */
+    id, 
+    /** @docsNotRequired */
     url, urlAfterRedirects, state) {
         super(id, url);
         this.urlAfterRedirects = urlAfterRedirects;
@@ -197,8 +216,10 @@ class GuardsCheckStart extends RouterEvent {
      * @param {?} urlAfterRedirects
      * @param {?} state
      */
-    constructor(/** @docsNotRequired */
-    id, /** @docsNotRequired */
+    constructor(
+    /** @docsNotRequired */
+    id, 
+    /** @docsNotRequired */
     url, urlAfterRedirects, state) {
         super(id, url);
         this.urlAfterRedirects = urlAfterRedirects;
@@ -226,8 +247,10 @@ class GuardsCheckEnd extends RouterEvent {
      * @param {?} state
      * @param {?} shouldActivate
      */
-    constructor(/** @docsNotRequired */
-    id, /** @docsNotRequired */
+    constructor(
+    /** @docsNotRequired */
+    id, 
+    /** @docsNotRequired */
     url, urlAfterRedirects, state, shouldActivate) {
         super(id, url);
         this.urlAfterRedirects = urlAfterRedirects;
@@ -258,8 +281,10 @@ class ResolveStart extends RouterEvent {
      * @param {?} urlAfterRedirects
      * @param {?} state
      */
-    constructor(/** @docsNotRequired */
-    id, /** @docsNotRequired */
+    constructor(
+    /** @docsNotRequired */
+    id, 
+    /** @docsNotRequired */
     url, urlAfterRedirects, state) {
         super(id, url);
         this.urlAfterRedirects = urlAfterRedirects;
@@ -287,8 +312,10 @@ class ResolveEnd extends RouterEvent {
      * @param {?} urlAfterRedirects
      * @param {?} state
      */
-    constructor(/** @docsNotRequired */
-    id, /** @docsNotRequired */
+    constructor(
+    /** @docsNotRequired */
+    id, 
+    /** @docsNotRequired */
     url, urlAfterRedirects, state) {
         super(id, url);
         this.urlAfterRedirects = urlAfterRedirects;
@@ -448,10 +475,7 @@ class Scroll {
      * @param {?} position
      * @param {?} anchor
      */
-    constructor(/** @docsNotRequired */
-    routerEvent, /** @docsNotRequired */
-    position, /** @docsNotRequired */
-    anchor) {
+    constructor(routerEvent, position, anchor) {
         this.routerEvent = routerEvent;
         this.position = position;
         this.anchor = anchor;
@@ -468,7 +492,7 @@ class Scroll {
 
 /**
  * @fileoverview added by tsickle
- * @suppress {checkTypes,extraRequire,uselessCode} checked by tsc
+ * @suppress {checkTypes,extraRequire,missingReturn,unusedPrivateMembers,uselessCode} checked by tsc
  */
 /**
  * This component is used internally within the router to be a placeholder when an empty
@@ -487,7 +511,7 @@ EmptyOutletComponent.decorators = [
 
 /**
  * @fileoverview added by tsickle
- * @suppress {checkTypes,extraRequire,uselessCode} checked by tsc
+ * @suppress {checkTypes,extraRequire,missingReturn,unusedPrivateMembers,uselessCode} checked by tsc
  */
 /**
  * @license
@@ -496,13 +520,14 @@ EmptyOutletComponent.decorators = [
  * Use of this source code is governed by an MIT-style license that can be
  * found in the LICENSE file at https://angular.io/license
  */
-/** *
+/**
  * \@description
  *
  * Name of the primary outlet.
  *
  * \@publicApi
-  @type {?} */
+ * @type {?}
+ */
 const PRIMARY_OUTLET = 'primary';
 class ParamsAsMap {
     /**
@@ -562,7 +587,7 @@ const NAVIGATION_CANCELING_ERROR = 'ngNavigationCancelingError';
 function navigationCancelingError(message) {
     /** @type {?} */
     const error = Error('NavigationCancelingError: ' + message);
-    (/** @type {?} */ (error))[NAVIGATION_CANCELING_ERROR] = true;
+    ((/** @type {?} */ (error)))[NAVIGATION_CANCELING_ERROR] = true;
     return error;
 }
 /**
@@ -570,8 +595,9 @@ function navigationCancelingError(message) {
  * @return {?}
  */
 function isNavigationCancelingError(error) {
-    return error && (/** @type {?} */ (error))[NAVIGATION_CANCELING_ERROR];
+    return error && ((/** @type {?} */ (error)))[NAVIGATION_CANCELING_ERROR];
 }
+// Matches the route configuration (`route`) against the actual URL (`segments`).
 /**
  * @param {?} segments
  * @param {?} segmentGroup
@@ -580,7 +606,7 @@ function isNavigationCancelingError(error) {
  */
 function defaultUrlMatcher(segments, segmentGroup, route) {
     /** @type {?} */
-    const parts = /** @type {?} */ ((route.path)).split('/');
+    const parts = (/** @type {?} */ (route.path)).split('/');
     if (parts.length > segments.length) {
         // The actual URL is shorter than the config, no match
         return null;
@@ -613,7 +639,7 @@ function defaultUrlMatcher(segments, segmentGroup, route) {
 
 /**
  * @fileoverview added by tsickle
- * @suppress {checkTypes,extraRequire,uselessCode} checked by tsc
+ * @suppress {checkTypes,extraRequire,missingReturn,unusedPrivateMembers,uselessCode} checked by tsc
  */
 class LoadedRouterConfig {
     /**
@@ -742,7 +768,7 @@ function standardizeConfig(r) {
 
 /**
  * @fileoverview added by tsickle
- * @suppress {checkTypes,extraRequire,uselessCode} checked by tsc
+ * @suppress {checkTypes,extraRequire,missingReturn,unusedPrivateMembers,uselessCode} checked by tsc
  */
 /**
  * @param {?} a
@@ -861,7 +887,7 @@ function wrapIntoObservable(value) {
 
 /**
  * @fileoverview added by tsickle
- * @suppress {checkTypes,extraRequire,uselessCode} checked by tsc
+ * @suppress {checkTypes,extraRequire,missingReturn,unusedPrivateMembers,uselessCode} checked by tsc
  */
 /**
  * @return {?}
@@ -1207,7 +1233,7 @@ class DefaultUrlSerializer {
         /** @type {?} */
         const query = serializeQueryParams(tree.queryParams);
         /** @type {?} */
-        const fragment = typeof tree.fragment === `string` ? `#${encodeUriFragment((/** @type {?} */ ((tree.fragment))))}` : '';
+        const fragment = typeof tree.fragment === `string` ? `#${encodeUriFragment((/** @type {?} */ (tree.fragment)))}` : '';
         return `${segment}${query}${fragment}`;
     }
 }
@@ -1310,6 +1336,8 @@ function encodeUriSegment(s) {
 function decode(s) {
     return decodeURIComponent(s);
 }
+// Query keys/values should have the "+" replaced first, as "+" in a query string is " ".
+// decodeURIComponent function will not decode "+" as a space.
 /**
  * @param {?} s
  * @return {?}
@@ -1361,6 +1389,7 @@ function matchSegments(str) {
 }
 /** @type {?} */
 const QUERY_PARAM_RE = /^[^=?&#]+/;
+// Return the name of the query param at the start of the string or an empty string
 /**
  * @param {?} str
  * @return {?}
@@ -1372,6 +1401,7 @@ function matchQueryParams(str) {
 }
 /** @type {?} */
 const QUERY_PARAM_VALUE_RE = /^[^?&#]+/;
+// Return the value of the query param at the start of the string or an empty string
 /**
  * @param {?} str
  * @return {?}
@@ -1420,6 +1450,7 @@ class UrlParser {
         return this.consumeOptional('#') ? decodeURIComponent(this.remaining) : null;
     }
     /**
+     * @private
      * @return {?}
      */
     parseChildren() {
@@ -1452,7 +1483,10 @@ class UrlParser {
         }
         return res;
     }
+    // parse a segment with its matrix parameters
+    // ie `name;k1=v1;k2`
     /**
+     * @private
      * @return {?}
      */
     parseSegment() {
@@ -1465,6 +1499,7 @@ class UrlParser {
         return new UrlSegment(decode(path), this.parseMatrixParams());
     }
     /**
+     * @private
      * @return {?}
      */
     parseMatrixParams() {
@@ -1476,6 +1511,7 @@ class UrlParser {
         return params;
     }
     /**
+     * @private
      * @param {?} params
      * @return {?}
      */
@@ -1498,7 +1534,9 @@ class UrlParser {
         }
         params[decode(key)] = decode(value);
     }
+    // Parse a single query parameter `name[=value]`
     /**
+     * @private
      * @param {?} params
      * @return {?}
      */
@@ -1524,6 +1562,7 @@ class UrlParser {
         /** @type {?} */
         const decodedVal = decodeQuery(value);
         if (params.hasOwnProperty(decodedKey)) {
+            // Append to existing values
             /** @type {?} */
             let currentVal = params[decodedKey];
             if (!Array.isArray(currentVal)) {
@@ -1537,7 +1576,9 @@ class UrlParser {
             params[decodedKey] = decodedVal;
         }
     }
+    // parse `(a/b//outlet_name:c/d)`
     /**
+     * @private
      * @param {?} allowPrimary
      * @return {?}
      */
@@ -1556,7 +1597,7 @@ class UrlParser {
                 throw new Error(`Cannot parse url '${this.url}'`);
             }
             /** @type {?} */
-            let outletName = /** @type {?} */ ((undefined));
+            let outletName = (/** @type {?} */ (undefined));
             if (path.indexOf(':') > -1) {
                 outletName = path.substr(0, path.indexOf(':'));
                 this.capture(outletName);
@@ -1574,11 +1615,14 @@ class UrlParser {
         return segments;
     }
     /**
+     * @private
      * @param {?} str
      * @return {?}
      */
     peekStartsWith(str) { return this.remaining.startsWith(str); }
+    // Consumes the prefix when it is present and returns whether it has been consumed
     /**
+     * @private
      * @param {?} str
      * @return {?}
      */
@@ -1590,6 +1634,7 @@ class UrlParser {
         return false;
     }
     /**
+     * @private
      * @param {?} str
      * @return {?}
      */
@@ -1602,7 +1647,7 @@ class UrlParser {
 
 /**
  * @fileoverview added by tsickle
- * @suppress {checkTypes,extraRequire,uselessCode} checked by tsc
+ * @suppress {checkTypes,extraRequire,missingReturn,unusedPrivateMembers,uselessCode} checked by tsc
  */
 /**
  * @license
@@ -1674,6 +1719,7 @@ class Tree {
      */
     pathFromRoot(t) { return findPath(t, this._root).map(s => s.value); }
 }
+// DFS for the node matching the value
 /**
  * @template T
  * @param {?} value
@@ -1691,6 +1737,7 @@ function findNode(value, node) {
     }
     return null;
 }
+// Return the path to the node with the given value using DFS
 /**
  * @template T
  * @param {?} value
@@ -1727,6 +1774,7 @@ class TreeNode {
      */
     toString() { return `TreeNode(${this.value})`; }
 }
+// Return the list of T indexed by outlet name
 /**
  * @template T
  * @param {?} node
@@ -1743,7 +1791,7 @@ function nodeChildrenAsMap(node) {
 
 /**
  * @fileoverview added by tsickle
- * @suppress {checkTypes,extraRequire,uselessCode} checked by tsc
+ * @suppress {checkTypes,extraRequire,missingReturn,unusedPrivateMembers,uselessCode} checked by tsc
  */
 /**
  * \@description
@@ -1782,7 +1830,7 @@ class RouterState extends Tree {
     constructor(root, snapshot) {
         super(root);
         this.snapshot = snapshot;
-        setRouterState(/** @type {?} */ (this), root);
+        setRouterState((/** @type {?} */ (this)), root);
     }
     /**
      * @return {?}
@@ -1977,7 +2025,7 @@ function flattenInherited(pathFromRoot) {
         /** @type {?} */
         const resolve = Object.assign({}, res.resolve, curr._resolvedData);
         return { params, data, resolve };
-    }, /** @type {?} */ ({ params: {}, data: {}, resolve: {} }));
+    }, (/** @type {?} */ ({ params: {}, data: {}, resolve: {} })));
 }
 /**
  * \@description
@@ -2117,7 +2165,7 @@ class RouterStateSnapshot extends Tree {
     constructor(url, root) {
         super(root);
         this.url = url;
-        setRouterState(/** @type {?} */ (this), root);
+        setRouterState((/** @type {?} */ (this)), root);
     }
     /**
      * @return {?}
@@ -2158,25 +2206,25 @@ function advanceActivatedRoute(route) {
         const nextSnapshot = route._futureSnapshot;
         route.snapshot = nextSnapshot;
         if (!shallowEqual(currentSnapshot.queryParams, nextSnapshot.queryParams)) {
-            (/** @type {?} */ (route.queryParams)).next(nextSnapshot.queryParams);
+            ((/** @type {?} */ (route.queryParams))).next(nextSnapshot.queryParams);
         }
         if (currentSnapshot.fragment !== nextSnapshot.fragment) {
-            (/** @type {?} */ (route.fragment)).next(nextSnapshot.fragment);
+            ((/** @type {?} */ (route.fragment))).next(nextSnapshot.fragment);
         }
         if (!shallowEqual(currentSnapshot.params, nextSnapshot.params)) {
-            (/** @type {?} */ (route.params)).next(nextSnapshot.params);
+            ((/** @type {?} */ (route.params))).next(nextSnapshot.params);
         }
         if (!shallowEqualArrays(currentSnapshot.url, nextSnapshot.url)) {
-            (/** @type {?} */ (route.url)).next(nextSnapshot.url);
+            ((/** @type {?} */ (route.url))).next(nextSnapshot.url);
         }
         if (!shallowEqual(currentSnapshot.data, nextSnapshot.data)) {
-            (/** @type {?} */ (route.data)).next(nextSnapshot.data);
+            ((/** @type {?} */ (route.data))).next(nextSnapshot.data);
         }
     }
     else {
         route.snapshot = route._futureSnapshot;
         // this is for resolved data
-        (/** @type {?} */ (route.data)).next(route._futureSnapshot.data);
+        ((/** @type {?} */ (route.data))).next(route._futureSnapshot.data);
     }
 }
 /**
@@ -2190,12 +2238,12 @@ function equalParamsAndUrlSegments(a, b) {
     /** @type {?} */
     const parentsMismatch = !a.parent !== !b.parent;
     return equalUrlParams && !parentsMismatch &&
-        (!a.parent || equalParamsAndUrlSegments(a.parent, /** @type {?} */ ((b.parent))));
+        (!a.parent || equalParamsAndUrlSegments(a.parent, (/** @type {?} */ (b.parent))));
 }
 
 /**
  * @fileoverview added by tsickle
- * @suppress {checkTypes,extraRequire,uselessCode} checked by tsc
+ * @suppress {checkTypes,extraRequire,missingReturn,unusedPrivateMembers,uselessCode} checked by tsc
  */
 /**
  * @param {?} routeReuseStrategy
@@ -2227,7 +2275,7 @@ function createNode(routeReuseStrategy, curr, prevState) {
     }
     else {
         /** @type {?} */
-        const detachedRouteHandle = /** @type {?} */ (routeReuseStrategy.retrieve(curr.value));
+        const detachedRouteHandle = (/** @type {?} */ (routeReuseStrategy.retrieve(curr.value)));
         if (detachedRouteHandle) {
             /** @type {?} */
             const tree = detachedRouteHandle.route;
@@ -2286,7 +2334,7 @@ function createActivatedRoute(c) {
 
 /**
  * @fileoverview added by tsickle
- * @suppress {checkTypes,extraRequire,uselessCode} checked by tsc
+ * @suppress {checkTypes,extraRequire,missingReturn,unusedPrivateMembers,uselessCode} checked by tsc
  */
 /**
  * @param {?} route
@@ -2421,11 +2469,9 @@ function computeNavigation(commands) {
             cmd.split('/').forEach((urlPart, partIndex) => {
                 if (partIndex == 0 && urlPart === '.') ;
                 else if (partIndex == 0 && urlPart === '') { //  '/a'
-                    //  '/a'
                     isAbsolute = true;
                 }
                 else if (urlPart === '..') { //  '../a'
-                    //  '../a'
                     numberOfDoubleDots++;
                 }
                 else if (urlPart != '') {
@@ -2484,7 +2530,7 @@ function createPositionApplyingDoubleDots(group, index, numberOfDoubleDots) {
     let dd = numberOfDoubleDots;
     while (dd > ci) {
         dd -= ci;
-        g = /** @type {?} */ ((g.parent));
+        g = (/** @type {?} */ (g.parent));
         if (!g) {
             throw new Error('Invalid number of \'../\'');
         }
@@ -2692,11 +2738,11 @@ function compare(path, params, segment) {
 
 /**
  * @fileoverview added by tsickle
- * @suppress {checkTypes,extraRequire,uselessCode} checked by tsc
+ * @suppress {checkTypes,extraRequire,missingReturn,unusedPrivateMembers,uselessCode} checked by tsc
  */
 /** @type {?} */
 const activateRoutes = (rootContexts, routeReuseStrategy, forwardEvent) => map(t => {
-    new ActivateRoutes(routeReuseStrategy, /** @type {?} */ ((t.targetRouterState)), t.currentRouterState, forwardEvent)
+    new ActivateRoutes(routeReuseStrategy, (/** @type {?} */ (t.targetRouterState)), t.currentRouterState, forwardEvent)
         .activate(rootContexts);
     return t;
 });
@@ -2726,7 +2772,9 @@ class ActivateRoutes {
         advanceActivatedRoute(this.futureState.root);
         this.activateChildRoutes(futureRoot, currRoot, parentContexts);
     }
+    // De-activate the child route that are not re-used for the future state
     /**
+     * @private
      * @param {?} futureNode
      * @param {?} currNode
      * @param {?} contexts
@@ -2748,6 +2796,7 @@ class ActivateRoutes {
         });
     }
     /**
+     * @private
      * @param {?} futureNode
      * @param {?} currNode
      * @param {?} parentContext
@@ -2761,6 +2810,7 @@ class ActivateRoutes {
         if (future === curr) {
             // Reusing the node, check to see if the children need to be de-activated
             if (future.component) {
+                // If we have a normal route, we need to go through an outlet.
                 /** @type {?} */
                 const context = parentContext.getContext(future.outlet);
                 if (context) {
@@ -2780,6 +2830,7 @@ class ActivateRoutes {
         }
     }
     /**
+     * @private
      * @param {?} route
      * @param {?} parentContexts
      * @return {?}
@@ -2793,6 +2844,7 @@ class ActivateRoutes {
         }
     }
     /**
+     * @private
      * @param {?} route
      * @param {?} parentContexts
      * @return {?}
@@ -2809,6 +2861,7 @@ class ActivateRoutes {
         }
     }
     /**
+     * @private
      * @param {?} route
      * @param {?} parentContexts
      * @return {?}
@@ -2831,6 +2884,7 @@ class ActivateRoutes {
         }
     }
     /**
+     * @private
      * @param {?} futureNode
      * @param {?} currNode
      * @param {?} contexts
@@ -2848,6 +2902,7 @@ class ActivateRoutes {
         }
     }
     /**
+     * @private
      * @param {?} futureNode
      * @param {?} currNode
      * @param {?} parentContexts
@@ -2862,6 +2917,7 @@ class ActivateRoutes {
         // reusing the node
         if (future === curr) {
             if (future.component) {
+                // If we have a normal route, we need to go through an outlet.
                 /** @type {?} */
                 const context = parentContexts.getOrCreateContext(future.outlet);
                 this.activateChildRoutes(futureNode, currNode, context.children);
@@ -2873,11 +2929,12 @@ class ActivateRoutes {
         }
         else {
             if (future.component) {
+                // if we have a normal route, we need to place the component into the outlet and recurse.
                 /** @type {?} */
                 const context = parentContexts.getOrCreateContext(future.outlet);
                 if (this.routeReuseStrategy.shouldAttach(future.snapshot)) {
                     /** @type {?} */
-                    const stored = (/** @type {?} */ (this.routeReuseStrategy.retrieve(future.snapshot)));
+                    const stored = ((/** @type {?} */ (this.routeReuseStrategy.retrieve(future.snapshot))));
                     this.routeReuseStrategy.store(future.snapshot, null);
                     context.children.onOutletReAttached(stored.contexts);
                     context.attachRef = stored.componentRef;
@@ -2938,7 +2995,7 @@ function parentLoadedConfig(snapshot) {
 
 /**
  * @fileoverview added by tsickle
- * @suppress {checkTypes,extraRequire,uselessCode} checked by tsc
+ * @suppress {checkTypes,extraRequire,missingReturn,unusedPrivateMembers,uselessCode} checked by tsc
  */
 /**
  * Simple function check, but generic so type inference will flow. Example:
@@ -3005,7 +3062,7 @@ function isCanDeactivate(guard) {
 
 /**
  * @fileoverview added by tsickle
- * @suppress {checkTypes,extraRequire,uselessCode} checked by tsc
+ * @suppress {checkTypes,extraRequire,missingReturn,unusedPrivateMembers,uselessCode} checked by tsc
  */
 class NoMatch {
     /**
@@ -3086,7 +3143,7 @@ class ApplyRedirects {
         /** @type {?} */
         const expanded$ = this.expandSegmentGroup(this.ngModule, this.config, this.urlTree.root, PRIMARY_OUTLET);
         /** @type {?} */
-        const urlTrees$ = expanded$.pipe(map((rootSegmentGroup) => this.createUrlTree(rootSegmentGroup, this.urlTree.queryParams, /** @type {?} */ ((this.urlTree.fragment)))));
+        const urlTrees$ = expanded$.pipe(map((rootSegmentGroup) => this.createUrlTree(rootSegmentGroup, this.urlTree.queryParams, (/** @type {?} */ (this.urlTree.fragment)))));
         return urlTrees$.pipe(catchError((e) => {
             if (e instanceof AbsoluteRedirect) {
                 // after an absolute redirect we do not apply any more redirects!
@@ -3101,6 +3158,7 @@ class ApplyRedirects {
         }));
     }
     /**
+     * @private
      * @param {?} tree
      * @return {?}
      */
@@ -3108,7 +3166,7 @@ class ApplyRedirects {
         /** @type {?} */
         const expanded$ = this.expandSegmentGroup(this.ngModule, this.config, tree.root, PRIMARY_OUTLET);
         /** @type {?} */
-        const mapped$ = expanded$.pipe(map((rootSegmentGroup) => this.createUrlTree(rootSegmentGroup, tree.queryParams, /** @type {?} */ ((tree.fragment)))));
+        const mapped$ = expanded$.pipe(map((rootSegmentGroup) => this.createUrlTree(rootSegmentGroup, tree.queryParams, (/** @type {?} */ (tree.fragment)))));
         return mapped$.pipe(catchError((e) => {
             if (e instanceof NoMatch) {
                 throw this.noMatchError(e);
@@ -3117,6 +3175,7 @@ class ApplyRedirects {
         }));
     }
     /**
+     * @private
      * @param {?} e
      * @return {?}
      */
@@ -3124,6 +3183,7 @@ class ApplyRedirects {
         return new Error(`Cannot match any routes. URL Segment: '${e.segmentGroup}'`);
     }
     /**
+     * @private
      * @param {?} rootCandidate
      * @param {?} queryParams
      * @param {?} fragment
@@ -3137,6 +3197,7 @@ class ApplyRedirects {
         return new UrlTree(root, queryParams, fragment);
     }
     /**
+     * @private
      * @param {?} ngModule
      * @param {?} routes
      * @param {?} segmentGroup
@@ -3150,7 +3211,9 @@ class ApplyRedirects {
         }
         return this.expandSegment(ngModule, segmentGroup, routes, segmentGroup.segments, outlet, true);
     }
+    // Recursively expand segment groups for all the child outlets
     /**
+     * @private
      * @param {?} ngModule
      * @param {?} routes
      * @param {?} segmentGroup
@@ -3160,6 +3223,7 @@ class ApplyRedirects {
         return waitForMap(segmentGroup.children, (childOutlet, child) => this.expandSegmentGroup(ngModule, routes, child, childOutlet));
     }
     /**
+     * @private
      * @param {?} ngModule
      * @param {?} segmentGroup
      * @param {?} routes
@@ -3176,7 +3240,7 @@ class ApplyRedirects {
                 if (e instanceof NoMatch) {
                     // TODO(i): this return type doesn't match the declared Observable<UrlSegmentGroup> -
                     // talk to Jason
-                    return /** @type {?} */ (of(null));
+                    return (/** @type {?} */ (of(null)));
                 }
                 throw e;
             }));
@@ -3191,6 +3255,7 @@ class ApplyRedirects {
         }));
     }
     /**
+     * @private
      * @param {?} segmentGroup
      * @param {?} segments
      * @param {?} outlet
@@ -3200,6 +3265,7 @@ class ApplyRedirects {
         return segments.length === 0 && !segmentGroup.children[outlet];
     }
     /**
+     * @private
      * @param {?} ngModule
      * @param {?} segmentGroup
      * @param {?} routes
@@ -3222,6 +3288,7 @@ class ApplyRedirects {
         return noMatch(segmentGroup);
     }
     /**
+     * @private
      * @param {?} ngModule
      * @param {?} segmentGroup
      * @param {?} routes
@@ -3237,6 +3304,7 @@ class ApplyRedirects {
         return this.expandRegularSegmentAgainstRouteUsingRedirect(ngModule, segmentGroup, routes, route, segments, outlet);
     }
     /**
+     * @private
      * @param {?} ngModule
      * @param {?} routes
      * @param {?} route
@@ -3245,8 +3313,8 @@ class ApplyRedirects {
      */
     expandWildCardWithParamsAgainstRouteUsingRedirect(ngModule, routes, route, outlet) {
         /** @type {?} */
-        const newTree = this.applyRedirectCommands([], /** @type {?} */ ((route.redirectTo)), {});
-        if (/** @type {?} */ ((route.redirectTo)).startsWith('/')) {
+        const newTree = this.applyRedirectCommands([], (/** @type {?} */ (route.redirectTo)), {});
+        if ((/** @type {?} */ (route.redirectTo)).startsWith('/')) {
             return absoluteRedirect(newTree);
         }
         return this.lineralizeSegments(route, newTree).pipe(mergeMap((newSegments) => {
@@ -3256,6 +3324,7 @@ class ApplyRedirects {
         }));
     }
     /**
+     * @private
      * @param {?} ngModule
      * @param {?} segmentGroup
      * @param {?} routes
@@ -3269,8 +3338,8 @@ class ApplyRedirects {
         if (!matched)
             return noMatch(segmentGroup);
         /** @type {?} */
-        const newTree = this.applyRedirectCommands(consumedSegments, /** @type {?} */ ((route.redirectTo)), /** @type {?} */ (positionalParamSegments));
-        if (/** @type {?} */ ((route.redirectTo)).startsWith('/')) {
+        const newTree = this.applyRedirectCommands(consumedSegments, (/** @type {?} */ (route.redirectTo)), (/** @type {?} */ (positionalParamSegments)));
+        if ((/** @type {?} */ (route.redirectTo)).startsWith('/')) {
             return absoluteRedirect(newTree);
         }
         return this.lineralizeSegments(route, newTree).pipe(mergeMap((newSegments) => {
@@ -3278,6 +3347,7 @@ class ApplyRedirects {
         }));
     }
     /**
+     * @private
      * @param {?} ngModule
      * @param {?} rawSegmentGroup
      * @param {?} route
@@ -3322,6 +3392,7 @@ class ApplyRedirects {
         }));
     }
     /**
+     * @private
      * @param {?} ngModule
      * @param {?} route
      * @param {?} segments
@@ -3352,6 +3423,7 @@ class ApplyRedirects {
         return of(new LoadedRouterConfig([], ngModule));
     }
     /**
+     * @private
      * @param {?} route
      * @param {?} urlTree
      * @return {?}
@@ -3367,12 +3439,13 @@ class ApplyRedirects {
                 return of(res);
             }
             if (c.numberOfChildren > 1 || !c.children[PRIMARY_OUTLET]) {
-                return namedOutletsRedirect(/** @type {?} */ ((route.redirectTo)));
+                return namedOutletsRedirect((/** @type {?} */ (route.redirectTo)));
             }
             c = c.children[PRIMARY_OUTLET];
         }
     }
     /**
+     * @private
      * @param {?} segments
      * @param {?} redirectTo
      * @param {?} posParams
@@ -3382,6 +3455,7 @@ class ApplyRedirects {
         return this.applyRedirectCreatreUrlTree(redirectTo, this.urlSerializer.parse(redirectTo), segments, posParams);
     }
     /**
+     * @private
      * @param {?} redirectTo
      * @param {?} urlTree
      * @param {?} segments
@@ -3394,6 +3468,7 @@ class ApplyRedirects {
         return new UrlTree(newRoot, this.createQueryParams(urlTree.queryParams, this.urlTree.queryParams), urlTree.fragment);
     }
     /**
+     * @private
      * @param {?} redirectToParams
      * @param {?} actualParams
      * @return {?}
@@ -3416,6 +3491,7 @@ class ApplyRedirects {
         return res;
     }
     /**
+     * @private
      * @param {?} redirectTo
      * @param {?} group
      * @param {?} segments
@@ -3433,6 +3509,7 @@ class ApplyRedirects {
         return new UrlSegmentGroup(updatedSegments, children);
     }
     /**
+     * @private
      * @param {?} redirectTo
      * @param {?} redirectToSegments
      * @param {?} actualSegments
@@ -3444,6 +3521,7 @@ class ApplyRedirects {
             this.findOrReturn(s, actualSegments));
     }
     /**
+     * @private
      * @param {?} redirectTo
      * @param {?} redirectToUrlSegment
      * @param {?} posParams
@@ -3457,6 +3535,7 @@ class ApplyRedirects {
         return pos;
     }
     /**
+     * @private
      * @param {?} redirectToUrlSegment
      * @param {?} actualSegments
      * @return {?}
@@ -3524,16 +3603,16 @@ function match(segmentGroup, route, segments) {
     if (!res) {
         return {
             matched: false,
-            consumedSegments: /** @type {?} */ ([]),
+            consumedSegments: (/** @type {?} */ ([])),
             lastChild: 0,
             positionalParamSegments: {},
         };
     }
     return {
         matched: true,
-        consumedSegments: /** @type {?} */ ((res.consumed)),
-        lastChild: /** @type {?} */ ((res.consumed.length)),
-        positionalParamSegments: /** @type {?} */ ((res.posParams)),
+        consumedSegments: (/** @type {?} */ (res.consumed)),
+        lastChild: (/** @type {?} */ (res.consumed.length)),
+        positionalParamSegments: (/** @type {?} */ (res.posParams)),
     };
 }
 /**
@@ -3643,7 +3722,7 @@ function getOutlet(route) {
 
 /**
  * @fileoverview added by tsickle
- * @suppress {checkTypes,extraRequire,uselessCode} checked by tsc
+ * @suppress {checkTypes,extraRequire,missingReturn,unusedPrivateMembers,uselessCode} checked by tsc
  */
 /**
  * @param {?} moduleInjector
@@ -3661,7 +3740,7 @@ function applyRedirects$1(moduleInjector, configLoader, urlSerializer, config) {
 
 /**
  * @fileoverview added by tsickle
- * @suppress {checkTypes,extraRequire,uselessCode} checked by tsc
+ * @suppress {checkTypes,extraRequire,missingReturn,unusedPrivateMembers,uselessCode} checked by tsc
  */
 class CanActivate {
     /**
@@ -3754,7 +3833,7 @@ function getChildRouteGuards(futureNode, currNode, contexts, futurePath, checks
         delete prevChildren[c.value.outlet];
     });
     // Process any children left from the current route (not active for the future route)
-    forEach(prevChildren, (v, k) => deactivateRouteAndItsChildren(v, /** @type {?} */ ((contexts)).getContext(k), checks));
+    forEach(prevChildren, (v, k) => deactivateRouteAndItsChildren(v, (/** @type {?} */ (contexts)).getContext(k), checks));
     return checks;
 }
 /**
@@ -3778,7 +3857,7 @@ function getRouteGuards(futureNode, currNode, parentContexts, futurePath, checks
     // reusing the node
     if (curr && future.routeConfig === curr.routeConfig) {
         /** @type {?} */
-        const shouldRun = shouldRunGuardsAndResolvers(curr, future, /** @type {?} */ ((future.routeConfig)).runGuardsAndResolvers);
+        const shouldRun = shouldRunGuardsAndResolvers(curr, future, (/** @type {?} */ (future.routeConfig)).runGuardsAndResolvers);
         if (shouldRun) {
             checks.canActivateChecks.push(new CanActivate(futurePath));
         }
@@ -3824,9 +3903,15 @@ function getRouteGuards(futureNode, currNode, parentContexts, futurePath, checks
  * @return {?}
  */
 function shouldRunGuardsAndResolvers(curr, future, mode) {
+    if (typeof mode === 'function') {
+        return mode(curr, future);
+    }
     switch (mode) {
         case 'pathParamsChange':
             return !equalPath(curr.url, future.url);
+        case 'pathParamsOrQueryParamsChange':
+            return !equalPath(curr.url, future.url) ||
+                !shallowEqual(curr.queryParams, future.queryParams);
         case 'always':
             return true;
         case 'paramsOrQueryParamsChange':
@@ -3872,7 +3957,7 @@ function deactivateRouteAndItsChildren(route, context, checks) {
 
 /**
  * @fileoverview added by tsickle
- * @suppress {checkTypes,extraRequire,uselessCode} checked by tsc
+ * @suppress {checkTypes,extraRequire,missingReturn,unusedPrivateMembers,uselessCode} checked by tsc
  */
 /** @type {?} */
 const INITIAL_VALUE = Symbol('INITIAL_VALUE');
@@ -3881,7 +3966,7 @@ const INITIAL_VALUE = Symbol('INITIAL_VALUE');
  */
 function prioritizedGuardValue() {
     return switchMap(obs => {
-        return /** @type {?} */ (combineLatest(...obs.map(o => o.pipe(take(1), startWith(/** @type {?} */ (INITIAL_VALUE)))))
+        return (/** @type {?} */ (combineLatest(...obs.map(o => o.pipe(take(1), startWith((/** @type {?} */ (INITIAL_VALUE))))))
             .pipe(scan((acc, list) => {
             /** @type {?} */
             let isPending = false;
@@ -3907,14 +3992,13 @@ function prioritizedGuardValue() {
                 return innerAcc;
             }, acc);
         }, INITIAL_VALUE), filter(item => item !== INITIAL_VALUE), map(item => isUrlTree(item) ? item : item === true), //
-        //
-        take(1)));
+        take(1))));
     });
 }
 
 /**
  * @fileoverview added by tsickle
- * @suppress {checkTypes,extraRequire,uselessCode} checked by tsc
+ * @suppress {checkTypes,extraRequire,missingReturn,unusedPrivateMembers,uselessCode} checked by tsc
  */
 /**
  * @param {?} moduleInjector
@@ -3928,10 +4012,10 @@ function checkGuards(moduleInjector, forwardEvent) {
             if (canDeactivateChecks.length === 0 && canActivateChecks.length === 0) {
                 return of(Object.assign({}, t, { guardsResult: true }));
             }
-            return runCanDeactivateChecks(canDeactivateChecks, /** @type {?} */ ((targetSnapshot)), currentSnapshot, moduleInjector)
+            return runCanDeactivateChecks(canDeactivateChecks, (/** @type {?} */ (targetSnapshot)), currentSnapshot, moduleInjector)
                 .pipe(mergeMap(canDeactivate => {
                 return canDeactivate && isBoolean(canDeactivate) ?
-                    runCanActivateChecks(/** @type {?} */ ((targetSnapshot)), canActivateChecks, moduleInjector, forwardEvent) :
+                    runCanActivateChecks((/** @type {?} */ (targetSnapshot)), canActivateChecks, moduleInjector, forwardEvent) :
                     of(canDeactivate);
             }), map(guardsResult => (Object.assign({}, t, { guardsResult }))));
         }));
@@ -3945,7 +4029,7 @@ function checkGuards(moduleInjector, forwardEvent) {
  * @return {?}
  */
 function runCanDeactivateChecks(checks, futureRSS, currRSS, moduleInjector) {
-    return from(checks).pipe(mergeMap(check => runCanDeactivate(check.component, check.route, currRSS, futureRSS, moduleInjector)), first(result => { return result !== true; }, /** @type {?} */ (true)));
+    return from(checks).pipe(mergeMap(check => runCanDeactivate(check.component, check.route, currRSS, futureRSS, moduleInjector)), first(result => { return result !== true; }, (/** @type {?} */ (true))));
 }
 /**
  * @param {?} futureSnapshot
@@ -3964,8 +4048,8 @@ function runCanActivateChecks(futureSnapshot, checks, moduleInjector, forwardEve
         ])
             .pipe(concatAll(), first(result => {
             return result !== true;
-        }, /** @type {?} */ (true)));
-    }), first(result => { return result !== true; }, /** @type {?} */ (true)));
+        }, (/** @type {?} */ (true))));
+    }), first(result => { return result !== true; }, (/** @type {?} */ (true))));
 }
 /**
  * This should fire off `ActivationStart` events for each route being activated at this
@@ -4093,7 +4177,7 @@ function runCanDeactivate(component, currARS, currRSS, futureRSS, moduleInjector
         let observable;
         if (isCanDeactivate(guard)) {
             observable =
-                wrapIntoObservable(guard.canDeactivate(/** @type {?} */ ((component)), currARS, currRSS, futureRSS));
+                wrapIntoObservable(guard.canDeactivate((/** @type {?} */ (component)), currARS, currRSS, futureRSS));
         }
         else if (isFunction(guard)) {
             observable = wrapIntoObservable(guard(component, currARS, currRSS, futureRSS));
@@ -4108,7 +4192,7 @@ function runCanDeactivate(component, currARS, currRSS, futureRSS, moduleInjector
 
 /**
  * @fileoverview added by tsickle
- * @suppress {checkTypes,extraRequire,uselessCode} checked by tsc
+ * @suppress {checkTypes,extraRequire,missingReturn,unusedPrivateMembers,uselessCode} checked by tsc
  */
 class NoMatch$1 {
 }
@@ -4152,7 +4236,7 @@ class Recognizer {
             /** @type {?} */
             const children = this.processSegmentGroup(this.config, rootSegmentGroup, PRIMARY_OUTLET);
             /** @type {?} */
-            const root = new ActivatedRouteSnapshot([], Object.freeze({}), Object.freeze(Object.assign({}, this.urlTree.queryParams)), /** @type {?} */ ((this.urlTree.fragment)), {}, PRIMARY_OUTLET, this.rootComponentType, null, this.urlTree.root, -1, {});
+            const root = new ActivatedRouteSnapshot([], Object.freeze({}), Object.freeze(Object.assign({}, this.urlTree.queryParams)), (/** @type {?} */ (this.urlTree.fragment)), {}, PRIMARY_OUTLET, this.rootComponentType, null, this.urlTree.root, -1, {});
             /** @type {?} */
             const rootNode = new TreeNode(root, children);
             /** @type {?} */
@@ -4224,6 +4308,7 @@ class Recognizer {
         throw new NoMatch$1();
     }
     /**
+     * @private
      * @param {?} segmentGroup
      * @param {?} segments
      * @param {?} outlet
@@ -4252,15 +4337,15 @@ class Recognizer {
         let rawSlicedSegments = [];
         if (route.path === '**') {
             /** @type {?} */
-            const params = segments.length > 0 ? /** @type {?} */ ((last$1(segments))).parameters : {};
-            snapshot = new ActivatedRouteSnapshot(segments, params, Object.freeze(Object.assign({}, this.urlTree.queryParams)), /** @type {?} */ ((this.urlTree.fragment)), getData(route), outlet, /** @type {?} */ ((route.component)), route, getSourceSegmentGroup(rawSegment), getPathIndexShift(rawSegment) + segments.length, getResolve(route));
+            const params = segments.length > 0 ? (/** @type {?} */ (last$1(segments))).parameters : {};
+            snapshot = new ActivatedRouteSnapshot(segments, params, Object.freeze(Object.assign({}, this.urlTree.queryParams)), (/** @type {?} */ (this.urlTree.fragment)), getData(route), outlet, (/** @type {?} */ (route.component)), route, getSourceSegmentGroup(rawSegment), getPathIndexShift(rawSegment) + segments.length, getResolve(route));
         }
         else {
             /** @type {?} */
             const result = match$1(rawSegment, route, segments);
             consumedSegments = result.consumedSegments;
             rawSlicedSegments = segments.slice(result.lastChild);
-            snapshot = new ActivatedRouteSnapshot(consumedSegments, result.parameters, Object.freeze(Object.assign({}, this.urlTree.queryParams)), /** @type {?} */ ((this.urlTree.fragment)), getData(route), outlet, /** @type {?} */ ((route.component)), route, getSourceSegmentGroup(rawSegment), getPathIndexShift(rawSegment) + consumedSegments.length, getResolve(route));
+            snapshot = new ActivatedRouteSnapshot(consumedSegments, result.parameters, Object.freeze(Object.assign({}, this.urlTree.queryParams)), (/** @type {?} */ (this.urlTree.fragment)), getData(route), outlet, (/** @type {?} */ (route.component)), route, getSourceSegmentGroup(rawSegment), getPathIndexShift(rawSegment) + consumedSegments.length, getResolve(route));
         }
         /** @type {?} */
         const childConfig = getChildConfig(route);
@@ -4300,7 +4385,7 @@ function getChildConfig(route) {
         return route.children;
     }
     if (route.loadChildren) {
-        return /** @type {?} */ ((route._loadedConfig)).routes;
+        return (/** @type {?} */ (route._loadedConfig)).routes;
     }
     return [];
 }
@@ -4325,7 +4410,7 @@ function match$1(segmentGroup, route, segments) {
         throw new NoMatch$1();
     /** @type {?} */
     const posParams = {};
-    forEach(/** @type {?} */ ((res.posParams)), (v, k) => { posParams[k] = v.path; });
+    forEach((/** @type {?} */ (res.posParams)), (v, k) => { posParams[k] = v.path; });
     /** @type {?} */
     const parameters = res.consumed.length > 0 ? Object.assign({}, posParams, res.consumed[res.consumed.length - 1].parameters) :
         posParams;
@@ -4515,7 +4600,7 @@ function getResolve(route) {
 
 /**
  * @fileoverview added by tsickle
- * @suppress {checkTypes,extraRequire,uselessCode} checked by tsc
+ * @suppress {checkTypes,extraRequire,missingReturn,unusedPrivateMembers,uselessCode} checked by tsc
  */
 /**
  * @param {?} rootComponentType
@@ -4534,7 +4619,7 @@ function recognize$1(rootComponentType, config, serializer, paramsInheritanceStr
 
 /**
  * @fileoverview added by tsickle
- * @suppress {checkTypes,extraRequire,uselessCode} checked by tsc
+ * @suppress {checkTypes,extraRequire,missingReturn,unusedPrivateMembers,uselessCode} checked by tsc
  */
 /**
  * @param {?} paramsInheritanceStrategy
@@ -4549,7 +4634,7 @@ function resolveData(paramsInheritanceStrategy, moduleInjector) {
                 return of(t);
             }
             return from(canActivateChecks)
-                .pipe(concatMap(check => runResolve(check.route, /** @type {?} */ ((targetSnapshot)), paramsInheritanceStrategy, moduleInjector)), reduce((_, __) => _), map(_ => t));
+                .pipe(concatMap(check => runResolve(check.route, (/** @type {?} */ (targetSnapshot)), paramsInheritanceStrategy, moduleInjector)), reduce((_, __) => _), map(_ => t));
         }));
     };
 }
@@ -4617,7 +4702,7 @@ function getResolver(injectionToken, futureARS, futureRSS, moduleInjector) {
 
 /**
  * @fileoverview added by tsickle
- * @suppress {checkTypes,extraRequire,uselessCode} checked by tsc
+ * @suppress {checkTypes,extraRequire,missingReturn,unusedPrivateMembers,uselessCode} checked by tsc
  */
 /**
  * Perform a side effect through a switchMap for every emission on the source Observable,
@@ -4643,7 +4728,14 @@ function switchTap(next) {
 
 /**
  * @fileoverview added by tsickle
- * @suppress {checkTypes,extraRequire,uselessCode} checked by tsc
+ * @suppress {checkTypes,extraRequire,missingReturn,unusedPrivateMembers,uselessCode} checked by tsc
+ */
+/**
+ * @license
+ * Copyright Google Inc. All Rights Reserved.
+ *
+ * Use of this source code is governed by an MIT-style license that can be
+ * found in the LICENSE file at https://angular.io/license
  */
 /**
  * \@description
@@ -4692,12 +4784,13 @@ class DefaultRouteReuseStrategy {
 
 /**
  * @fileoverview added by tsickle
- * @suppress {checkTypes,extraRequire,uselessCode} checked by tsc
+ * @suppress {checkTypes,extraRequire,missingReturn,unusedPrivateMembers,uselessCode} checked by tsc
  */
-/** *
+/**
  * \@docsNotRequired
  * \@publicApi
-  @type {?} */
+ * @type {?}
+ */
 const ROUTES = new InjectionToken('ROUTES');
 class RouterConfigLoader {
     /**
@@ -4722,7 +4815,7 @@ class RouterConfigLoader {
             this.onLoadStartListener(route);
         }
         /** @type {?} */
-        const moduleFactory$ = this.loadModuleFactory(/** @type {?} */ ((route.loadChildren)));
+        const moduleFactory$ = this.loadModuleFactory((/** @type {?} */ (route.loadChildren)));
         return moduleFactory$.pipe(map((factory) => {
             if (this.onLoadEndListener) {
                 this.onLoadEndListener(route);
@@ -4733,6 +4826,7 @@ class RouterConfigLoader {
         }));
     }
     /**
+     * @private
      * @param {?} loadChildren
      * @return {?}
      */
@@ -4755,7 +4849,7 @@ class RouterConfigLoader {
 
 /**
  * @fileoverview added by tsickle
- * @suppress {checkTypes,extraRequire,uselessCode} checked by tsc
+ * @suppress {checkTypes,extraRequire,missingReturn,unusedPrivateMembers,uselessCode} checked by tsc
  */
 /**
  * @license
@@ -4798,7 +4892,7 @@ class DefaultUrlHandlingStrategy {
 
 /**
  * @fileoverview added by tsickle
- * @suppress {checkTypes,extraRequire,uselessCode} checked by tsc
+ * @suppress {checkTypes,extraRequire,missingReturn,unusedPrivateMembers,uselessCode} checked by tsc
  */
 /**
  * @param {?} error
@@ -4823,7 +4917,7 @@ function defaultMalformedUriErrorHandler(error, urlSerializer, url) {
  * @return {?}
  */
 function defaultRouterHook(snapshot, runExtras) {
-    return /** @type {?} */ (of(null));
+    return (/** @type {?} */ (of(null)));
 }
 /**
  * \@description
@@ -4848,12 +4942,15 @@ class Router {
      * @param {?} compiler
      * @param {?} config
      */
+    // TODO: vsavkin make internal after the final is out.
     constructor(rootComponentType, urlSerializer, rootContexts, location, injector, loader, compiler, config) {
         this.rootComponentType = rootComponentType;
         this.urlSerializer = urlSerializer;
         this.rootContexts = rootContexts;
         this.location = location;
         this.config = config;
+        this.lastSuccessfulNavigation = null;
+        this.currentNavigation = null;
         this.navigationId = 0;
         this.isNgZoneEnabled = false;
         this.events = new Subject();
@@ -4945,7 +5042,7 @@ class Router {
             reject: null,
             promise: Promise.resolve(true),
             source: 'imperative',
-            state: null,
+            restoredState: null,
             currentSnapshot: this.routerState.snapshot,
             targetSnapshot: null,
             currentRouterState: this.routerState,
@@ -4957,15 +5054,28 @@ class Router {
         this.processNavigations();
     }
     /**
+     * @private
      * @param {?} transitions
      * @return {?}
      */
     setupNavigations(transitions) {
         /** @type {?} */
-        const eventsSubject = (/** @type {?} */ (this.events));
-        return /** @type {?} */ ((transitions.pipe(filter(t => t.id !== 0), 
+        const eventsSubject = ((/** @type {?} */ (this.events)));
+        return (/** @type {?} */ ((/** @type {?} */ (transitions.pipe(filter(t => t.id !== 0), 
         // Extract URL
-        map(t => (/** @type {?} */ (Object.assign({}, t, { extractedUrl: this.urlHandlingStrategy.extract(t.rawUrl) })))), 
+        map(t => ((/** @type {?} */ (Object.assign({}, t, { extractedUrl: this.urlHandlingStrategy.extract(t.rawUrl) }))))), 
+        // Store the Navigation object
+        tap(t => {
+            this.currentNavigation = {
+                id: t.id,
+                initialUrl: t.currentRawUrl,
+                extractedUrl: t.extractedUrl,
+                trigger: t.source,
+                extras: t.extras,
+                previousNavigation: this.lastSuccessfulNavigation ? Object.assign({}, this.lastSuccessfulNavigation, { previousNavigation: null }) :
+                    null
+            };
+        }), 
         // Using switchMap so we cancel executing navigations when a new one comes in
         switchMap(t => {
             /** @type {?} */
@@ -4980,14 +5090,11 @@ class Router {
                     this.urlHandlingStrategy.shouldProcessUrl(t.rawUrl);
                 if (processCurrentUrl) {
                     return of(t).pipe(
-                    // Update URL if in `eager` update mode
-                    tap(t => this.urlUpdateStrategy === 'eager' && !t.extras.skipLocationChange &&
-                        this.setBrowserUrl(t.rawUrl, !!t.extras.replaceUrl, t.id)), 
                     // Fire NavigationStart event
                     switchMap(t => {
                         /** @type {?} */
                         const transition = this.transitions.getValue();
-                        eventsSubject.next(new NavigationStart(t.id, this.serializeUrl(t.extractedUrl), t.source, t.state));
+                        eventsSubject.next(new NavigationStart(t.id, this.serializeUrl(t.extractedUrl), t.source, t.restoredState));
                         if (transition !== this.transitions.getValue()) {
                             return EMPTY;
                         }
@@ -4998,12 +5105,19 @@ class Router {
                     switchMap(t => Promise.resolve(t)), 
                     // ApplyRedirects
                     applyRedirects$1(this.ngModule.injector, this.configLoader, this.urlSerializer, this.config), 
+                    // Update the currentNavigation
+                    tap(t => {
+                        this.currentNavigation = Object.assign({}, (/** @type {?} */ (this.currentNavigation)), { finalUrl: t.urlAfterRedirects });
+                    }), 
                     // Recognize
                     recognize$1(this.rootComponentType, this.config, (url) => this.serializeUrl(url), this.paramsInheritanceStrategy, this.relativeLinkResolution), 
+                    // Update URL if in `eager` update mode
+                    tap(t => this.urlUpdateStrategy === 'eager' && !t.extras.skipLocationChange &&
+                        this.setBrowserUrl(t.urlAfterRedirects, !!t.extras.replaceUrl, t.id)), 
                     // Fire RoutesRecognized
                     tap(t => {
                         /** @type {?} */
-                        const routesRecognized = new RoutesRecognized(t.id, this.serializeUrl(t.extractedUrl), this.serializeUrl(t.urlAfterRedirects), /** @type {?} */ ((t.targetSnapshot)));
+                        const routesRecognized = new RoutesRecognized(t.id, this.serializeUrl(t.extractedUrl), this.serializeUrl(t.urlAfterRedirects), (/** @type {?} */ (t.targetSnapshot)));
                         eventsSubject.next(routesRecognized);
                     }));
                 }
@@ -5012,12 +5126,12 @@ class Router {
                     const processPreviousUrl = urlTransition && this.rawUrlTree &&
                         this.urlHandlingStrategy.shouldProcessUrl(this.rawUrlTree);
                     /* When the current URL shouldn't be processed, but the previous one was, we
-                                       * handle this "error condition" by navigating to the previously successful URL,
-                                       * but leaving the URL intact.*/
+                     * handle this "error condition" by navigating to the previously successful URL,
+                     * but leaving the URL intact.*/
                     if (processPreviousUrl) {
-                        const { id, extractedUrl, source, state, extras } = t;
+                        const { id, extractedUrl, source, restoredState, extras } = t;
                         /** @type {?} */
-                        const navStart = new NavigationStart(id, this.serializeUrl(extractedUrl), source, state);
+                        const navStart = new NavigationStart(id, this.serializeUrl(extractedUrl), source, restoredState);
                         eventsSubject.next(navStart);
                         /** @type {?} */
                         const targetSnapshot = createEmptyState(extractedUrl, this.rootComponentType).snapshot;
@@ -5025,9 +5139,9 @@ class Router {
                     }
                     else {
                         /* When neither the current or previous URL can be processed, do nothing other
-                                             * than update router's internal reference to the current "settled" URL. This
-                                             * way the next navigation will be coming from the current URL in the browser.
-                                             */
+                         * than update router's internal reference to the current "settled" URL. This
+                         * way the next navigation will be coming from the current URL in the browser.
+                         */
                         this.rawUrlTree = t.rawUrl;
                         t.resolve(null);
                         return EMPTY;
@@ -5037,7 +5151,7 @@ class Router {
             // Before Preactivation
             switchTap(t => {
                 const { targetSnapshot, id: navigationId, extractedUrl: appliedUrlTree, rawUrl: rawUrlTree, extras: { skipLocationChange, replaceUrl } } = t;
-                return this.hooks.beforePreactivation(/** @type {?} */ ((targetSnapshot)), {
+                return this.hooks.beforePreactivation((/** @type {?} */ (targetSnapshot)), {
                     navigationId,
                     appliedUrlTree,
                     rawUrlTree,
@@ -5048,9 +5162,9 @@ class Router {
             // --- GUARDS ---
             tap(t => {
                 /** @type {?} */
-                const guardsStart = new GuardsCheckStart(t.id, this.serializeUrl(t.extractedUrl), this.serializeUrl(t.urlAfterRedirects), /** @type {?} */ ((t.targetSnapshot)));
+                const guardsStart = new GuardsCheckStart(t.id, this.serializeUrl(t.extractedUrl), this.serializeUrl(t.urlAfterRedirects), (/** @type {?} */ (t.targetSnapshot)));
                 this.triggerEvent(guardsStart);
-            }), map(t => (Object.assign({}, t, { guards: getAllRouteGuards(/** @type {?} */ ((t.targetSnapshot)), t.currentSnapshot, this.rootContexts) }))), checkGuards(this.ngModule.injector, (evt) => this.triggerEvent(evt)), tap(t => {
+            }), map(t => (Object.assign({}, t, { guards: getAllRouteGuards((/** @type {?} */ (t.targetSnapshot)), t.currentSnapshot, this.rootContexts) }))), checkGuards(this.ngModule.injector, (evt) => this.triggerEvent(evt)), tap(t => {
                 if (isUrlTree(t.guardsResult)) {
                     /** @type {?} */
                     const error = navigationCancelingError(`Redirecting to "${this.serializeUrl(t.guardsResult)}"`);
@@ -5059,7 +5173,7 @@ class Router {
                 }
             }), tap(t => {
                 /** @type {?} */
-                const guardsEnd = new GuardsCheckEnd(t.id, this.serializeUrl(t.extractedUrl), this.serializeUrl(t.urlAfterRedirects), /** @type {?} */ ((t.targetSnapshot)), !!t.guardsResult);
+                const guardsEnd = new GuardsCheckEnd(t.id, this.serializeUrl(t.extractedUrl), this.serializeUrl(t.urlAfterRedirects), (/** @type {?} */ (t.targetSnapshot)), !!t.guardsResult);
                 this.triggerEvent(guardsEnd);
             }), filter(t => {
                 if (!t.guardsResult) {
@@ -5077,58 +5191,56 @@ class Router {
                 if (t.guards.canActivateChecks.length) {
                     return of(t).pipe(tap(t => {
                         /** @type {?} */
-                        const resolveStart = new ResolveStart(t.id, this.serializeUrl(t.extractedUrl), this.serializeUrl(t.urlAfterRedirects), /** @type {?} */ ((t.targetSnapshot)));
+                        const resolveStart = new ResolveStart(t.id, this.serializeUrl(t.extractedUrl), this.serializeUrl(t.urlAfterRedirects), (/** @type {?} */ (t.targetSnapshot)));
                         this.triggerEvent(resolveStart);
                     }), resolveData(this.paramsInheritanceStrategy, this.ngModule.injector), //
-                    //
                     tap(t => {
                         /** @type {?} */
-                        const resolveEnd = new ResolveEnd(t.id, this.serializeUrl(t.extractedUrl), this.serializeUrl(t.urlAfterRedirects), /** @type {?} */ ((t.targetSnapshot)));
+                        const resolveEnd = new ResolveEnd(t.id, this.serializeUrl(t.extractedUrl), this.serializeUrl(t.urlAfterRedirects), (/** @type {?} */ (t.targetSnapshot)));
                         this.triggerEvent(resolveEnd);
                     }));
                 }
                 return undefined;
             }), 
             // --- AFTER PREACTIVATION ---
-            switchTap(t => {
+            switchTap((t) => {
                 const { targetSnapshot, id: navigationId, extractedUrl: appliedUrlTree, rawUrl: rawUrlTree, extras: { skipLocationChange, replaceUrl } } = t;
-                return this.hooks.afterPreactivation(/** @type {?} */ ((targetSnapshot)), {
+                return this.hooks.afterPreactivation((/** @type {?} */ (targetSnapshot)), {
                     navigationId,
                     appliedUrlTree,
                     rawUrlTree,
                     skipLocationChange: !!skipLocationChange,
                     replaceUrl: !!replaceUrl,
                 });
-            }), map(t => {
+            }), map((t) => {
                 /** @type {?} */
-                const targetRouterState = createRouterState(this.routeReuseStrategy, /** @type {?} */ ((t.targetSnapshot)), t.currentRouterState);
+                const targetRouterState = createRouterState(this.routeReuseStrategy, (/** @type {?} */ (t.targetSnapshot)), t.currentRouterState);
                 return (Object.assign({}, t, { targetRouterState }));
-            }), /* Once here, we are about to activate syncronously. The assumption is this will
-                             succeed, and user code may read from the Router service. Therefore before
-                             activation, we need to update router properties storing the current URL and the
-                             RouterState, as well as updated the browser URL. All this should happen *before*
-                             activating. */
-            tap(t => {
+            }), 
+            /* Once here, we are about to activate syncronously. The assumption is this will
+               succeed, and user code may read from the Router service. Therefore before
+               activation, we need to update router properties storing the current URL and the
+               RouterState, as well as updated the browser URL. All this should happen *before*
+               activating. */
+            tap((t) => {
                 this.currentUrlTree = t.urlAfterRedirects;
                 this.rawUrlTree = this.urlHandlingStrategy.merge(this.currentUrlTree, t.rawUrl);
-                (/** @type {?} */ (this)).routerState = /** @type {?} */ ((t.targetRouterState));
+                ((/** @type {?} */ (this))).routerState = (/** @type {?} */ (t.targetRouterState));
                 if (this.urlUpdateStrategy === 'deferred' && !t.extras.skipLocationChange) {
-                    this.setBrowserUrl(this.rawUrlTree, !!t.extras.replaceUrl, t.id);
+                    this.setBrowserUrl(this.rawUrlTree, !!t.extras.replaceUrl, t.id, t.extras.state);
                 }
-            }), activateRoutes(this.rootContexts, this.routeReuseStrategy, (evt) => this.triggerEvent(evt)), tap({
-                /**
+            }), activateRoutes(this.rootContexts, this.routeReuseStrategy, (evt) => this.triggerEvent(evt)), tap({ /**
                  * @return {?}
                  */
                 next() { completed = true; }, /**
                  * @return {?}
                  */
-                complete() { completed = true; }
-            }), finalize(() => {
+                complete() { completed = true; } }), finalize(() => {
                 /* When the navigation stream finishes either through error or success, we set the
-                                 * `completed` or `errored` flag. However, there are some situations where we could
-                                 * get here without either of those being set. For instance, a redirect during
-                                 * NavigationStart. Therefore, this is a catch-all to make sure the NavigationCancel
-                                 * event is fired when a navigation gets cancelled but not caught by other means. */
+                 * `completed` or `errored` flag. However, there are some situations where we could
+                 * get here without either of those being set. For instance, a redirect during
+                 * NavigationStart. Therefore, this is a catch-all to make sure the NavigationCancel
+                 * event is fired when a navigation gets cancelled but not caught by other means. */
                 if (!completed && !errored) {
                     // Must reset to current URL tree here to ensure history.state is set. On a fresh
                     // page load, if a new navigation comes in before a successful navigation
@@ -5142,10 +5254,14 @@ class Router {
                     eventsSubject.next(navCancel);
                     t.resolve(false);
                 }
+                // currentNavigation should always be reset to null here. If navigation was
+                // successful, lastSuccessfulTransition will have already been set. Therefore we
+                // can safely set currentNavigation to null here.
+                this.currentNavigation = null;
             }), catchError((e) => {
                 errored = true;
                 /* This error type is issued during Redirect, and is handled as a cancellation
-                                 * rather than an error. */
+                 * rather than an error. */
                 if (isNavigationCancelingError(e)) {
                     this.navigated = true;
                     /** @type {?} */
@@ -5161,7 +5277,7 @@ class Router {
                         this.navigateByUrl(e.url);
                     }
                     /* All other errors should reset to the router's internal URL reference to the
-                                       * pre-error state. */
+                     * pre-error state. */
                 }
                 else {
                     this.resetStateAndUrl(t.currentRouterState, t.currentUrlTree, t.rawUrl);
@@ -5178,7 +5294,7 @@ class Router {
                 return EMPTY;
             }));
             // TODO(jasonaden): remove cast once g3 is on updated TypeScript
-        }))));
+        }))))));
     }
     /**
      * \@internal
@@ -5193,10 +5309,12 @@ class Router {
         this.routerState.root.component = this.rootComponentType;
     }
     /**
+     * @private
      * @return {?}
      */
     getTransition() { return this.transitions.value; }
     /**
+     * @private
      * @param {?} t
      * @return {?}
      */
@@ -5222,17 +5340,17 @@ class Router {
         // already patch onPopState, so location change callback will
         // run into ngZone
         if (!this.locationSubscription) {
-            this.locationSubscription = /** @type {?} */ (this.location.subscribe((change) => {
+            this.locationSubscription = (/** @type {?} */ (this.location.subscribe((change) => {
                 /** @type {?} */
                 let rawUrlTree = this.parseUrl(change['url']);
                 /** @type {?} */
                 const source = change['type'] === 'popstate' ? 'popstate' : 'hashchange';
+                // Navigations coming from Angular router have a navigationId state property. When this
+                // exists, restore the state.
                 /** @type {?} */
-                const state = change.state && change.state.navigationId ?
-                    { navigationId: change.state.navigationId } :
-                    null;
+                const state = change.state && change.state.navigationId ? change.state : null;
                 setTimeout(() => { this.scheduleNavigation(rawUrlTree, source, state, { replaceUrl: true }); }, 0);
-            }));
+            })));
         }
     }
     /**
@@ -5240,12 +5358,17 @@ class Router {
      * @return {?}
      */
     get url() { return this.serializeUrl(this.currentUrlTree); }
+    /**
+     * The current Navigation object if one exists
+     * @return {?}
+     */
+    getCurrentNavigation() { return this.currentNavigation; }
     /**
      * \@internal
      * @param {?} event
      * @return {?}
      */
-    triggerEvent(event) { (/** @type {?} */ (this.events)).next(event); }
+    triggerEvent(event) { ((/** @type {?} */ (this.events))).next(event); }
     /**
      * Resets the configuration used for navigation and generating links.
      *
@@ -5282,7 +5405,7 @@ class Router {
     dispose() {
         if (this.locationSubscription) {
             this.locationSubscription.unsubscribe();
-            this.locationSubscription = /** @type {?} */ ((null));
+            this.locationSubscription = (/** @type {?} */ (null));
         }
     }
     /**
@@ -5333,7 +5456,7 @@ class Router {
      */
     createUrlTree(commands, navigationExtras = {}) {
         const { relativeTo, queryParams, fragment, preserveQueryParams, queryParamsHandling, preserveFragment } = navigationExtras;
-        if (isDevMode() && preserveQueryParams && /** @type {?} */ (console) && /** @type {?} */ (console.warn)) {
+        if (isDevMode() && preserveQueryParams && (/** @type {?} */ (console)) && (/** @type {?} */ (console.warn))) {
             console.warn('preserveQueryParams is deprecated, use queryParamsHandling instead.');
         }
         /** @type {?} */
@@ -5360,7 +5483,7 @@ class Router {
         if (q !== null) {
             q = this.removeEmptyProps(q);
         }
-        return createUrlTree(a, this.currentUrlTree, commands, /** @type {?} */ ((q)), /** @type {?} */ ((f)));
+        return createUrlTree(a, this.currentUrlTree, commands, (/** @type {?} */ (q)), (/** @type {?} */ (f)));
     }
     /**
      * Navigate based on the provided url. This navigation is always absolute.
@@ -5422,6 +5545,11 @@ class Router {
      * The first parameter of `navigate()` is a delta to be applied to the current URL
      * or the one provided in the `relativeTo` property of the second parameter (the
      * `NavigationExtras`).
+     *
+     * In order to affect this browser's `history.state` entry, the `state`
+     * parameter can be passed. This must be an object because the router
+     * will add the `navigationId` property to this object before creating
+     * the new history item.
      * @param {?} commands
      * @param {?=} extras
      * @return {?}
@@ -5467,6 +5595,7 @@ class Router {
         return containsTree(this.currentUrlTree, urlTree, exact);
     }
     /**
+     * @private
      * @param {?} params
      * @return {?}
      */
@@ -5481,25 +5610,29 @@ class Router {
         }, {});
     }
     /**
+     * @private
      * @return {?}
      */
     processNavigations() {
         this.navigations.subscribe(t => {
             this.navigated = true;
             this.lastSuccessfulId = t.id;
-            (/** @type {?} */ (this.events))
+            ((/** @type {?} */ (this.events)))
                 .next(new NavigationEnd(t.id, this.serializeUrl(t.extractedUrl), this.serializeUrl(this.currentUrlTree)));
+            this.lastSuccessfulNavigation = this.currentNavigation;
+            this.currentNavigation = null;
             t.resolve(true);
         }, e => { this.console.warn(`Unhandled Navigation Error: `); });
     }
     /**
+     * @private
      * @param {?} rawUrl
      * @param {?} source
-     * @param {?} state
+     * @param {?} restoredState
      * @param {?} extras
      * @return {?}
      */
-    scheduleNavigation(rawUrl, source, state, extras) {
+    scheduleNavigation(rawUrl, source, restoredState, extras) {
         /** @type {?} */
         const lastNavigation = this.getTransition();
         // If the user triggers a navigation imperatively (e.g., by using navigateByUrl),
@@ -5537,7 +5670,7 @@ class Router {
         this.setTransition({
             id,
             source,
-            state,
+            restoredState,
             currentUrlTree: this.currentUrlTree,
             currentRawUrl: this.rawUrlTree, rawUrl, extras, resolve, reject, promise,
             currentSnapshot: this.routerState.snapshot,
@@ -5548,34 +5681,40 @@ class Router {
         return promise.catch((e) => { return Promise.reject(e); });
     }
     /**
+     * @private
      * @param {?} url
      * @param {?} replaceUrl
      * @param {?} id
+     * @param {?=} state
      * @return {?}
      */
-    setBrowserUrl(url, replaceUrl, id) {
+    setBrowserUrl(url, replaceUrl, id, state) {
         /** @type {?} */
         const path = this.urlSerializer.serialize(url);
+        state = state || {};
         if (this.location.isCurrentPathEqualTo(path) || replaceUrl) {
-            this.location.replaceState(path, '', { navigationId: id });
+            // TODO(jasonaden): Remove first `navigationId` and rely on `ng` namespace.
+            this.location.replaceState(path, '', Object.assign({}, state, { navigationId: id }));
         }
         else {
-            this.location.go(path, '', { navigationId: id });
+            this.location.go(path, '', Object.assign({}, state, { navigationId: id }));
         }
     }
     /**
+     * @private
      * @param {?} storedState
      * @param {?} storedUrl
      * @param {?} rawUrl
      * @return {?}
      */
     resetStateAndUrl(storedState, storedUrl, rawUrl) {
-        (/** @type {?} */ (this)).routerState = storedState;
+        ((/** @type {?} */ (this))).routerState = storedState;
         this.currentUrlTree = storedUrl;
         this.rawUrlTree = this.urlHandlingStrategy.merge(this.currentUrlTree, rawUrl);
         this.resetUrlToCurrentUrlTree();
     }
     /**
+     * @private
      * @return {?}
      */
     resetUrlToCurrentUrlTree() {
@@ -5598,7 +5737,7 @@ function validateCommands(commands) {
 
 /**
  * @fileoverview added by tsickle
- * @suppress {checkTypes,extraRequire,uselessCode} checked by tsc
+ * @suppress {checkTypes,extraRequire,missingReturn,unusedPrivateMembers,uselessCode} checked by tsc
  */
 /**
  * \@description
@@ -5660,6 +5799,27 @@ function validateCommands(commands) {
  * </a>
  * ```
  *
+ * You can provide a `state` value to be persisted to the browser's History.state
+ * property (See https://developer.mozilla.org/en-US/docs/Web/API/History#Properties). It's
+ * used as follows:
+ *
+ * ```
+ * <a [routerLink]="['/user/bob']" [state]="{tracingId: 123}">
+ *   link to user component
+ * </a>
+ * ```
+ *
+ * And later the value can be read from the router through `router.getCurrentNavigation`.
+ * For example, to capture the `tracingId` above during the `NavigationStart` event:
+ *
+ * ```
+ * // Get NavigationStart events
+ * router.events.pipe(filter(e => e instanceof NavigationStart)).subscribe(e => {
+ *   const navigation = router.getCurrentNavigation();
+ *   tracingService.trace({id: navigation.extras.state.tracingId});
+ * });
+ * ```
+ *
  * The router link directive always treats the provided input as a delta to the current url.
  *
  * For instance, if the current url is `/user/(box//aux:team)`.
@@ -5707,7 +5867,7 @@ class RouterLink {
      * @return {?}
      */
     set preserveQueryParams(value) {
-        if (isDevMode() && /** @type {?} */ (console) && /** @type {?} */ (console.warn)) {
+        if (isDevMode() && (/** @type {?} */ (console)) && (/** @type {?} */ (console.warn))) {
             console.warn('preserveQueryParams is deprecated!, use queryParamsHandling instead.');
         }
         this.preserve = value;
@@ -5756,6 +5916,7 @@ RouterLink.propDecorators = {
     preserveFragment: [{ type: Input }],
     skipLocationChange: [{ type: Input }],
     replaceUrl: [{ type: Input }],
+    state: [{ type: Input }],
     routerLink: [{ type: Input }],
     preserveQueryParams: [{ type: Input }],
     onClick: [{ type: HostListener, args: ['click',] }]
@@ -5805,7 +5966,7 @@ class RouterLinkWithHref {
      * @return {?}
      */
     set preserveQueryParams(value) {
-        if (isDevMode() && /** @type {?} */ (console) && /** @type {?} */ (console.warn)) {
+        if (isDevMode() && (/** @type {?} */ (console)) && (/** @type {?} */ (console.warn))) {
             console.warn('preserveQueryParams is deprecated, use queryParamsHandling instead.');
         }
         this.preserve = value;
@@ -5837,11 +5998,13 @@ class RouterLinkWithHref {
         const extras = {
             skipLocationChange: attrBoolValue(this.skipLocationChange),
             replaceUrl: attrBoolValue(this.replaceUrl),
+            state: this.state
         };
         this.router.navigateByUrl(this.urlTree, extras);
         return false;
     }
     /**
+     * @private
      * @return {?}
      */
     updateTargetUrlAndHref() {
@@ -5878,6 +6041,7 @@ RouterLinkWithHref.propDecorators = {
     preserveFragment: [{ type: Input }],
     skipLocationChange: [{ type: Input }],
     replaceUrl: [{ type: Input }],
+    state: [{ type: Input }],
     href: [{ type: HostBinding }],
     routerLink: [{ type: Input }],
     preserveQueryParams: [{ type: Input }],
@@ -5893,7 +6057,7 @@ function attrBoolValue(s) {
 
 /**
  * @fileoverview added by tsickle
- * @suppress {checkTypes,extraRequire,uselessCode} checked by tsc
+ * @suppress {checkTypes,extraRequire,missingReturn,unusedPrivateMembers,uselessCode} checked by tsc
  */
 /**
  *
@@ -6000,6 +6164,7 @@ class RouterLinkActive {
      */
     ngOnDestroy() { this.subscription.unsubscribe(); }
     /**
+     * @private
      * @return {?}
      */
     update() {
@@ -6009,7 +6174,7 @@ class RouterLinkActive {
             /** @type {?} */
             const hasActiveLinks = this.hasActiveLinks();
             if (this.isActive !== hasActiveLinks) {
-                (/** @type {?} */ (this)).isActive = hasActiveLinks;
+                ((/** @type {?} */ (this))).isActive = hasActiveLinks;
                 this.classes.forEach((c) => {
                     if (hasActiveLinks) {
                         this.renderer.addClass(this.element.nativeElement, c);
@@ -6022,6 +6187,7 @@ class RouterLinkActive {
         });
     }
     /**
+     * @private
      * @param {?} router
      * @return {?}
      */
@@ -6029,6 +6195,7 @@ class RouterLinkActive {
         return (link) => router.isActive(link.urlTree, this.routerLinkActiveOptions.exact);
     }
     /**
+     * @private
      * @return {?}
      */
     hasActiveLinks() {
@@ -6058,7 +6225,7 @@ RouterLinkActive.propDecorators = {
 
 /**
  * @fileoverview added by tsickle
- * @suppress {checkTypes,extraRequire,uselessCode} checked by tsc
+ * @suppress {checkTypes,extraRequire,missingReturn,unusedPrivateMembers,uselessCode} checked by tsc
  */
 /**
  * @license
@@ -6088,6 +6255,7 @@ class OutletContext {
  */
 class ChildrenOutletContexts {
     constructor() {
+        // contexts for child outlets, by name.
         this.contexts = new Map();
     }
     /**
@@ -6154,7 +6322,7 @@ class ChildrenOutletContexts {
 
 /**
  * @fileoverview added by tsickle
- * @suppress {checkTypes,extraRequire,uselessCode} checked by tsc
+ * @suppress {checkTypes,extraRequire,missingReturn,unusedPrivateMembers,uselessCode} checked by tsc
  */
 /**
  * \@description
@@ -6208,6 +6376,8 @@ class RouterOutlet {
      */
     ngOnInit() {
         if (!this.activated) {
+            // If the outlet was not instantiated at the time the route got activated we need to populate
+            // the outlet when it is initialized (ie inside a NgIf)
             /** @type {?} */
             const context = this.parentContexts.getContext(this.name);
             if (context && context.route) {
@@ -6240,7 +6410,7 @@ class RouterOutlet {
     get activatedRoute() {
         if (!this.activated)
             throw new Error('Outlet is not activated');
-        return /** @type {?} */ (this._activatedRoute);
+        return (/** @type {?} */ (this._activatedRoute));
     }
     /**
      * @return {?}
@@ -6302,7 +6472,7 @@ class RouterOutlet {
         /** @type {?} */
         const snapshot = activatedRoute._futureSnapshot;
         /** @type {?} */
-        const component = /** @type {?} */ (/** @type {?} */ ((snapshot.routeConfig)).component);
+        const component = (/** @type {?} */ ((/** @type {?} */ (snapshot.routeConfig)).component));
         resolver = resolver || this.resolver;
         /** @type {?} */
         const factory = resolver.resolveComponentFactory(component);
@@ -6361,7 +6531,7 @@ class OutletInjector {
 
 /**
  * @fileoverview added by tsickle
- * @suppress {checkTypes,extraRequire,uselessCode} checked by tsc
+ * @suppress {checkTypes,extraRequire,missingReturn,unusedPrivateMembers,uselessCode} checked by tsc
  */
 /**
  * \@description
@@ -6458,11 +6628,15 @@ class RouterPreloader {
         const ngModule = this.injector.get(NgModuleRef);
         return this.processRoutes(ngModule, this.router.config);
     }
+    // TODO(jasonaden): This class relies on code external to the class to call setUpPreloading. If
+    // this hasn't been done, ngOnDestroy will fail as this.subscription will be undefined. This
+    // should be refactored.
     /**
      * @return {?}
      */
     ngOnDestroy() { this.subscription.unsubscribe(); }
     /**
+     * @private
      * @param {?} ngModule
      * @param {?} routes
      * @return {?}
@@ -6489,6 +6663,7 @@ class RouterPreloader {
         return from(res).pipe(mergeAll(), map((_) => void 0));
     }
     /**
+     * @private
      * @param {?} ngModule
      * @param {?} route
      * @return {?}
@@ -6518,7 +6693,7 @@ RouterPreloader.ctorParameters = () => [
 
 /**
  * @fileoverview added by tsickle
- * @suppress {checkTypes,extraRequire,uselessCode} checked by tsc
+ * @suppress {checkTypes,extraRequire,missingReturn,unusedPrivateMembers,uselessCode} checked by tsc
  */
 class RouterScroller {
     /**
@@ -6552,6 +6727,7 @@ class RouterScroller {
         this.scrollEventsSubscription = this.consumeScrollEvents();
     }
     /**
+     * @private
      * @return {?}
      */
     createScrollEvents() {
@@ -6569,6 +6745,7 @@ class RouterScroller {
         });
     }
     /**
+     * @private
      * @return {?}
      */
     consumeScrollEvents() {
@@ -6596,6 +6773,7 @@ class RouterScroller {
         });
     }
     /**
+     * @private
      * @param {?} routerEvent
      * @param {?} anchor
      * @return {?}
@@ -6618,27 +6796,30 @@ class RouterScroller {
 
 /**
  * @fileoverview added by tsickle
- * @suppress {checkTypes,extraRequire,uselessCode} checked by tsc
+ * @suppress {checkTypes,extraRequire,missingReturn,unusedPrivateMembers,uselessCode} checked by tsc
  */
-/** *
+/**
  * \@description
  *
  * Contains a list of directives
  *
  *
-  @type {?} */
+ * @type {?}
+ */
 const ROUTER_DIRECTIVES = [RouterOutlet, RouterLink, RouterLinkWithHref, RouterLinkActive, EmptyOutletComponent];
-/** *
+/**
  * \@description
  *
  * Is used in DI to configure the router.
  *
  * \@publicApi
-  @type {?} */
+ * @type {?}
+ */
 const ROUTER_CONFIGURATION = new InjectionToken('ROUTER_CONFIGURATION');
-/** *
+/**
  * \@docsNotRequired
-  @type {?} */
+ * @type {?}
+ */
 const ROUTER_FORROOT_GUARD = new InjectionToken('ROUTER_FORROOT_GUARD');
 /** @type {?} */
 const ROUTER_PROVIDERS = [
@@ -6719,6 +6900,7 @@ function routerNgProbeToken() {
  * \@publicApi
  */
 class RouterModule {
+    // Note: We are injecting the Router so it gets created eagerly...
     /**
      * @param {?} guard
      * @param {?} router
@@ -6944,7 +7126,7 @@ class RouterInitializer {
         const p = this.injector.get(LOCATION_INITIALIZED, Promise.resolve(null));
         return p.then(() => {
             /** @type {?} */
-            let resolve = /** @type {?} */ ((null));
+            let resolve = (/** @type {?} */ (null));
             /** @type {?} */
             const res = new Promise(r => resolve = r);
             /** @type {?} */
@@ -6968,7 +7150,7 @@ class RouterInitializer {
                         // subsequent navigations should not be delayed
                     }
                     else {
-                        return /** @type {?} */ (of(null));
+                        return (/** @type {?} */ (of(null)));
                     }
                 };
                 router.initialNavigation();
@@ -7006,10 +7188,11 @@ class RouterInitializer {
         preloader.setUpPreloading();
         routerScroller.init();
         router.resetRootComponentType(ref.componentTypes[0]);
-        this.resultOfPreactivationDone.next(/** @type {?} */ ((null)));
+        this.resultOfPreactivationDone.next((/** @type {?} */ (null)));
         this.resultOfPreactivationDone.complete();
     }
     /**
+     * @private
      * @param {?} opts
      * @return {?}
      */
@@ -7018,6 +7201,7 @@ class RouterInitializer {
             opts.initialNavigation === undefined;
     }
     /**
+     * @private
      * @param {?} opts
      * @return {?}
      */
@@ -7046,11 +7230,12 @@ function getAppInitializer(r) {
 function getBootstrapListener(r) {
     return r.bootstrapListener.bind(r);
 }
-/** *
+/**
  * A token for the router initializer that will be called after the app is bootstrapped.
  *
  * \@publicApi
-  @type {?} */
+ * @type {?}
+ */
 const ROUTER_INITIALIZER = new InjectionToken('Router Initializer');
 /**
  * @return {?}
@@ -7071,32 +7256,32 @@ function provideRouterInitializer() {
 
 /**
  * @fileoverview added by tsickle
- * @suppress {checkTypes,extraRequire,uselessCode} checked by tsc
+ * @suppress {checkTypes,extraRequire,missingReturn,unusedPrivateMembers,uselessCode} checked by tsc
  */
-/** *
+/**
  * \@publicApi
-  @type {?} */
-const VERSION = new Version('7.2.0-beta.0');
+ * @type {?}
+ */
+const VERSION = new Version('7.2.0');
 
 /**
  * @fileoverview added by tsickle
- * @suppress {checkTypes,extraRequire,uselessCode} checked by tsc
+ * @suppress {checkTypes,extraRequire,missingReturn,unusedPrivateMembers,uselessCode} checked by tsc
  */
 
 /**
  * @fileoverview added by tsickle
- * @suppress {checkTypes,extraRequire,uselessCode} checked by tsc
+ * @suppress {checkTypes,extraRequire,missingReturn,unusedPrivateMembers,uselessCode} checked by tsc
  */
 
 /**
  * @fileoverview added by tsickle
- * @suppress {checkTypes,extraRequire,uselessCode} checked by tsc
+ * @suppress {checkTypes,extraRequire,missingReturn,unusedPrivateMembers,uselessCode} checked by tsc
  */
-// This file only reexports content of the `src` folder. Keep it that way.
 
 /**
  * @fileoverview added by tsickle
- * @suppress {checkTypes,extraRequire,uselessCode} checked by tsc
+ * @suppress {checkTypes,extraRequire,missingReturn,unusedPrivateMembers,uselessCode} checked by tsc
  */
 
 /**