@angular/router 21.0.0-next.9 → 21.0.0-rc.1

package/fesm2022/upgrade.mjs

@@ -1,5 +1,5 @@
 /**
- * @license Angular v21.0.0-next.9
+ * @license Angular v21.0.0-rc.1
  * (c) 2010-2025 Google LLC. https://angular.dev/
  * License: MIT
  */
@@ -12,129 +12,55 @@ import 'rxjs';
 import 'rxjs/operators';
 import '@angular/platform-browser';
 
-/**
- * Creates an initializer that sets up `ngRoute` integration
- * along with setting up the Angular router.
- *
- * @usageNotes
- *
- * For standalone applications:
- * ```ts
- * export const appConfig: ApplicationConfig = {
- *   providers: [RouterUpgradeInitializer],
- * };
- * ```
- *
- * For NgModule based applications:
- * ```ts
- * @NgModule({
- *  imports: [
- *   RouterModule.forRoot(SOME_ROUTES),
- *   UpgradeModule
- * ],
- * providers: [
- *   RouterUpgradeInitializer
- * ]
- * })
- * export class AppModule {
- *   ngDoBootstrap() {}
- * }
- * ```
- *
- * @publicApi
- */
 const RouterUpgradeInitializer = {
-    provide: APP_BOOTSTRAP_LISTENER,
-    multi: true,
-    useFactory: locationSyncBootstrapListener,
+  provide: APP_BOOTSTRAP_LISTENER,
+  multi: true,
+  useFactory: locationSyncBootstrapListener
 };
-/**
- * @internal
- */
 function locationSyncBootstrapListener() {
-    const ngUpgrade = inject(UpgradeModule);
-    return () => {
-        setUpLocationSync(ngUpgrade);
-    };
+  const ngUpgrade = inject(UpgradeModule);
+  return () => {
+    setUpLocationSync(ngUpgrade);
+  };
 }
-/**
- * Sets up a location change listener to trigger `history.pushState`.
- * Works around the problem that `onPopState` does not trigger `history.pushState`.
- * Must be called *after* calling `UpgradeModule.bootstrap`.
- *
- * @param ngUpgrade The upgrade NgModule.
- * @param urlType The location strategy.
- * @see {@link /api/common/HashLocationStrategy HashLocationStrategy}
- * @see {@link /api/common/PathLocationStrategy PathLocationStrategy}
- *
- * @publicApi
- */
 function setUpLocationSync(ngUpgrade, urlType = 'path') {
-    if (!ngUpgrade.$injector) {
-        throw new Error(`
+  if (!ngUpgrade.$injector) {
+    throw new Error(`
         RouterUpgradeInitializer can be used only after UpgradeModule.bootstrap has been called.
         Remove RouterUpgradeInitializer and call setUpLocationSync after UpgradeModule.bootstrap.
       `);
+  }
+  const router = ngUpgrade.injector.get(Router);
+  const location = ngUpgrade.injector.get(Location);
+  ngUpgrade.$injector.get('$rootScope').$on('$locationChangeStart', (event, newUrl, oldUrl, newState, oldState) => {
+    const currentNavigationId = router.getCurrentNavigation()?.id;
+    const newStateNavigationId = newState?.navigationId;
+    if (newStateNavigationId !== undefined && newStateNavigationId === currentNavigationId) {
+      return;
+    }
+    let url;
+    if (urlType === 'path') {
+      url = resolveUrl(newUrl);
+    } else if (urlType === 'hash') {
+      const hashIdx = newUrl.indexOf('#');
+      url = resolveUrl(newUrl.substring(0, hashIdx) + newUrl.substring(hashIdx + 1));
+    } else {
+      throw 'Invalid URLType passed to setUpLocationSync: ' + urlType;
     }
-    const router = ngUpgrade.injector.get(Router);
-    const location = ngUpgrade.injector.get(Location);
-    ngUpgrade.$injector
-        .get('$rootScope')
-        .$on('$locationChangeStart', (event, newUrl, oldUrl, newState, oldState) => {
-        // Navigations coming from Angular router have a navigationId state
-        // property. Don't trigger Angular router navigation again if it is
-        // caused by a URL change from the current Angular router
-        // navigation.
-        const currentNavigationId = router.getCurrentNavigation()?.id;
-        const newStateNavigationId = newState?.navigationId;
-        if (newStateNavigationId !== undefined && newStateNavigationId === currentNavigationId) {
-            return;
-        }
-        let url;
-        if (urlType === 'path') {
-            url = resolveUrl(newUrl);
-        }
-        else if (urlType === 'hash') {
-            // Remove the first hash from the URL
-            const hashIdx = newUrl.indexOf('#');
-            url = resolveUrl(newUrl.substring(0, hashIdx) + newUrl.substring(hashIdx + 1));
-        }
-        else {
-            throw 'Invalid URLType passed to setUpLocationSync: ' + urlType;
-        }
-        const path = location.normalize(url.pathname);
-        router.navigateByUrl(path + url.search + url.hash);
-    });
+    const path = location.normalize(url.pathname);
+    router.navigateByUrl(path + url.search + url.hash);
+  });
 }
-/**
- * Normalizes and parses a URL.
- *
- * - Normalizing means that a relative URL will be resolved into an absolute URL in the context of
- *   the application document.
- * - Parsing means that the anchor's `protocol`, `hostname`, `port`, `pathname` and related
- *   properties are all populated to reflect the normalized URL.
- *
- * While this approach has wide compatibility, it doesn't work as expected on IE. On IE, normalizing
- * happens similar to other browsers, but the parsed components will not be set. (E.g. if you assign
- * `a.href = 'foo'`, then `a.protocol`, `a.host`, etc. will not be correctly updated.)
- * We work around that by performing the parsing in a 2nd step by taking a previously normalized URL
- * and assigning it again. This correctly populates all properties.
- *
- * See
- * https://github.com/angular/angular.js/blob/2c7400e7d07b0f6cec1817dab40b9250ce8ebce6/src/ng/urlUtils.js#L26-L33
- * for more info.
- */
 let anchor;
 function resolveUrl(url) {
-    anchor ??= document.createElement('a');
-    anchor.setAttribute('href', url);
-    anchor.setAttribute('href', anchor.href);
-    return {
-        // IE does not start `pathname` with `/` like other browsers.
-        pathname: `/${anchor.pathname.replace(/^\//, '')}`,
-        search: anchor.search,
-        hash: anchor.hash,
-    };
+  anchor ??= document.createElement('a');
+  anchor.setAttribute('href', url);
+  anchor.setAttribute('href', anchor.href);
+  return {
+    pathname: `/${anchor.pathname.replace(/^\//, '')}`,
+    search: anchor.search,
+    hash: anchor.hash
+  };
 }
 
 export { RouterUpgradeInitializer, locationSyncBootstrapListener, setUpLocationSync };

package/fesm2022/upgrade.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"upgrade.mjs","sources":["../../../../../k8-fastbuild-ST-199a4f3c4e20/bin/packages/router/upgrade/src/upgrade.ts"],"sourcesContent":["/**\n * @license\n * Copyright Google LLC All Rights Reserved.\n *\n * Use of this source code is governed by an MIT-style license that can be\n * found in the LICENSE file at https://angular.dev/license\n */\n\nimport {Location} from '@angular/common';\nimport {APP_BOOTSTRAP_LISTENER, ComponentRef, inject} from '@angular/core';\nimport {Router, ɵRestoredState as RestoredState} from '../../index';\nimport {UpgradeModule} from '@angular/upgrade/static';\n\n/**\n * Creates an initializer that sets up `ngRoute` integration\n * along with setting up the Angular router.\n *\n * @usageNotes\n *\n * For standalone applications:\n * ```ts\n * export const appConfig: ApplicationConfig = {\n *   providers: [RouterUpgradeInitializer],\n * };\n * ```\n *\n * For NgModule based applications:\n * ```ts\n * @NgModule({\n *  imports: [\n *   RouterModule.forRoot(SOME_ROUTES),\n *   UpgradeModule\n * ],\n * providers: [\n *   RouterUpgradeInitializer\n * ]\n * })\n * export class AppModule {\n *   ngDoBootstrap() {}\n * }\n * ```\n *\n * @publicApi\n */\nexport const RouterUpgradeInitializer = {\n  provide: APP_BOOTSTRAP_LISTENER,\n  multi: true,\n  useFactory: locationSyncBootstrapListener as () => () => void,\n};\n\n/**\n * @internal\n */\nexport function locationSyncBootstrapListener() {\n  const ngUpgrade = inject(UpgradeModule);\n\n  return () => {\n    setUpLocationSync(ngUpgrade);\n  };\n}\n\n/**\n * Sets up a location change listener to trigger `history.pushState`.\n * Works around the problem that `onPopState` does not trigger `history.pushState`.\n * Must be called *after* calling `UpgradeModule.bootstrap`.\n *\n * @param ngUpgrade The upgrade NgModule.\n * @param urlType The location strategy.\n * @see {@link /api/common/HashLocationStrategy HashLocationStrategy}\n * @see {@link /api/common/PathLocationStrategy PathLocationStrategy}\n *\n * @publicApi\n */\nexport function setUpLocationSync(\n  ngUpgrade: UpgradeModule,\n  urlType: 'path' | 'hash' = 'path',\n): void {\n  if (!ngUpgrade.$injector) {\n    throw new Error(`\n        RouterUpgradeInitializer can be used only after UpgradeModule.bootstrap has been called.\n        Remove RouterUpgradeInitializer and call setUpLocationSync after UpgradeModule.bootstrap.\n      `);\n  }\n\n  const router: Router = ngUpgrade.injector.get(Router);\n  const location: Location = ngUpgrade.injector.get(Location);\n\n  ngUpgrade.$injector\n    .get('$rootScope')\n    .$on(\n      '$locationChangeStart',\n      (\n        event: any,\n        newUrl: string,\n        oldUrl: string,\n        newState?: {[k: string]: unknown} | RestoredState,\n        oldState?: {[k: string]: unknown} | RestoredState,\n      ) => {\n        // Navigations coming from Angular router have a navigationId state\n        // property. Don't trigger Angular router navigation again if it is\n        // caused by a URL change from the current Angular router\n        // navigation.\n        const currentNavigationId = router.getCurrentNavigation()?.id;\n        const newStateNavigationId = newState?.navigationId;\n        if (newStateNavigationId !== undefined && newStateNavigationId === currentNavigationId) {\n          return;\n        }\n\n        let url;\n        if (urlType === 'path') {\n          url = resolveUrl(newUrl);\n        } else if (urlType === 'hash') {\n          // Remove the first hash from the URL\n          const hashIdx = newUrl.indexOf('#');\n          url = resolveUrl(newUrl.substring(0, hashIdx) + newUrl.substring(hashIdx + 1));\n        } else {\n          throw 'Invalid URLType passed to setUpLocationSync: ' + urlType;\n        }\n        const path = location.normalize(url.pathname);\n        router.navigateByUrl(path + url.search + url.hash);\n      },\n    );\n}\n\n/**\n * Normalizes and parses a URL.\n *\n * - Normalizing means that a relative URL will be resolved into an absolute URL in the context of\n *   the application document.\n * - Parsing means that the anchor's `protocol`, `hostname`, `port`, `pathname` and related\n *   properties are all populated to reflect the normalized URL.\n *\n * While this approach has wide compatibility, it doesn't work as expected on IE. On IE, normalizing\n * happens similar to other browsers, but the parsed components will not be set. (E.g. if you assign\n * `a.href = 'foo'`, then `a.protocol`, `a.host`, etc. will not be correctly updated.)\n * We work around that by performing the parsing in a 2nd step by taking a previously normalized URL\n * and assigning it again. This correctly populates all properties.\n *\n * See\n * https://github.com/angular/angular.js/blob/2c7400e7d07b0f6cec1817dab40b9250ce8ebce6/src/ng/urlUtils.js#L26-L33\n * for more info.\n */\nlet anchor: HTMLAnchorElement | undefined;\nfunction resolveUrl(url: string): {pathname: string; search: string; hash: string} {\n  anchor ??= document.createElement('a');\n\n  anchor.setAttribute('href', url);\n  anchor.setAttribute('href', anchor.href);\n\n  return {\n    // IE does not start `pathname` with `/` like other browsers.\n    pathname: `/${anchor.pathname.replace(/^\\//, '')}`,\n    search: anchor.search,\n    hash: anchor.hash,\n  };\n}\n"],"names":[],"mappings":";;;;;;;;;;;;;;AAaA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA8BG;AACU,MAAA,wBAAwB,GAAG;AACtC,IAAA,OAAO,EAAE,sBAAsB;AAC/B,IAAA,KAAK,EAAE,IAAI;AACX,IAAA,UAAU,EAAE,6BAAiD;;AAG/D;;AAEG;SACa,6BAA6B,GAAA;AAC3C,IAAA,MAAM,SAAS,GAAG,MAAM,CAAC,aAAa,CAAC;AAEvC,IAAA,OAAO,MAAK;QACV,iBAAiB,CAAC,SAAS,CAAC;AAC9B,KAAC;AACH;AAEA;;;;;;;;;;;AAWG;SACa,iBAAiB,CAC/B,SAAwB,EACxB,UAA2B,MAAM,EAAA;AAEjC,IAAA,IAAI,CAAC,SAAS,CAAC,SAAS,EAAE;QACxB,MAAM,IAAI,KAAK,CAAC;;;AAGb,MAAA,CAAA,CAAC;;IAGN,MAAM,MAAM,GAAW,SAAS,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC;IACrD,MAAM,QAAQ,GAAa,SAAS,CAAC,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC;AAE3D,IAAA,SAAS,CAAC;SACP,GAAG,CAAC,YAAY;AAChB,SAAA,GAAG,CACF,sBAAsB,EACtB,CACE,KAAU,EACV,MAAc,EACd,MAAc,EACd,QAAiD,EACjD,QAAiD,KAC/C;;;;;QAKF,MAAM,mBAAmB,GAAG,MAAM,CAAC,oBAAoB,EAAE,EAAE,EAAE;AAC7D,QAAA,MAAM,oBAAoB,GAAG,QAAQ,EAAE,YAAY;QACnD,IAAI,oBAAoB,KAAK,SAAS,IAAI,oBAAoB,KAAK,mBAAmB,EAAE;YACtF;;AAGF,QAAA,IAAI,GAAG;AACP,QAAA,IAAI,OAAO,KAAK,MAAM,EAAE;AACtB,YAAA,GAAG,GAAG,UAAU,CAAC,MAAM,CAAC;;AACnB,aAAA,IAAI,OAAO,KAAK,MAAM,EAAE;;YAE7B,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC;YACnC,GAAG,GAAG,UAAU,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,SAAS,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC;;aACzE;YACL,MAAM,+CAA+C,GAAG,OAAO;;QAEjE,MAAM,IAAI,GAAG,QAAQ,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC;AAC7C,QAAA,MAAM,CAAC,aAAa,CAAC,IAAI,GAAG,GAAG,CAAC,MAAM,GAAG,GAAG,CAAC,IAAI,CAAC;AACpD,KAAC,CACF;AACL;AAEA;;;;;;;;;;;;;;;;;AAiBG;AACH,IAAI,MAAqC;AACzC,SAAS,UAAU,CAAC,GAAW,EAAA;AAC7B,IAAA,MAAM,KAAK,QAAQ,CAAC,aAAa,CAAC,GAAG,CAAC;AAEtC,IAAA,MAAM,CAAC,YAAY,CAAC,MAAM,EAAE,GAAG,CAAC;IAChC,MAAM,CAAC,YAAY,CAAC,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC;IAExC,OAAO;;AAEL,QAAA,QAAQ,EAAE,CAAA,CAAA,EAAI,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAE,CAAA;QAClD,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,IAAI,EAAE,MAAM,CAAC,IAAI;KAClB;AACH;;;;"}
+{"version":3,"file":"upgrade.mjs","sources":["../../../../../darwin_arm64-fastbuild-ST-199a4f3c4e20/bin/packages/router/upgrade/src/upgrade.ts"],"sourcesContent":["/**\n * @license\n * Copyright Google LLC All Rights Reserved.\n *\n * Use of this source code is governed by an MIT-style license that can be\n * found in the LICENSE file at https://angular.dev/license\n */\n\nimport {Location} from '@angular/common';\nimport {APP_BOOTSTRAP_LISTENER, ComponentRef, inject} from '@angular/core';\nimport {Router, ɵRestoredState as RestoredState} from '../../index';\nimport {UpgradeModule} from '@angular/upgrade/static';\n\n/**\n * Creates an initializer that sets up `ngRoute` integration\n * along with setting up the Angular router.\n *\n * @usageNotes\n *\n * For standalone applications:\n * ```ts\n * export const appConfig: ApplicationConfig = {\n *   providers: [RouterUpgradeInitializer],\n * };\n * ```\n *\n * For NgModule based applications:\n * ```ts\n * @NgModule({\n *  imports: [\n *   RouterModule.forRoot(SOME_ROUTES),\n *   UpgradeModule\n * ],\n * providers: [\n *   RouterUpgradeInitializer\n * ]\n * })\n * export class AppModule {\n *   ngDoBootstrap() {}\n * }\n * ```\n *\n * @publicApi\n */\nexport const RouterUpgradeInitializer = {\n  provide: APP_BOOTSTRAP_LISTENER,\n  multi: true,\n  useFactory: locationSyncBootstrapListener as () => () => void,\n};\n\n/**\n * @internal\n */\nexport function locationSyncBootstrapListener() {\n  const ngUpgrade = inject(UpgradeModule);\n\n  return () => {\n    setUpLocationSync(ngUpgrade);\n  };\n}\n\n/**\n * Sets up a location change listener to trigger `history.pushState`.\n * Works around the problem that `onPopState` does not trigger `history.pushState`.\n * Must be called *after* calling `UpgradeModule.bootstrap`.\n *\n * @param ngUpgrade The upgrade NgModule.\n * @param urlType The location strategy.\n * @see {@link /api/common/HashLocationStrategy HashLocationStrategy}\n * @see {@link /api/common/PathLocationStrategy PathLocationStrategy}\n *\n * @publicApi\n */\nexport function setUpLocationSync(\n  ngUpgrade: UpgradeModule,\n  urlType: 'path' | 'hash' = 'path',\n): void {\n  if (!ngUpgrade.$injector) {\n    throw new Error(`\n        RouterUpgradeInitializer can be used only after UpgradeModule.bootstrap has been called.\n        Remove RouterUpgradeInitializer and call setUpLocationSync after UpgradeModule.bootstrap.\n      `);\n  }\n\n  const router: Router = ngUpgrade.injector.get(Router);\n  const location: Location = ngUpgrade.injector.get(Location);\n\n  ngUpgrade.$injector\n    .get('$rootScope')\n    .$on(\n      '$locationChangeStart',\n      (\n        event: any,\n        newUrl: string,\n        oldUrl: string,\n        newState?: {[k: string]: unknown} | RestoredState,\n        oldState?: {[k: string]: unknown} | RestoredState,\n      ) => {\n        // Navigations coming from Angular router have a navigationId state\n        // property. Don't trigger Angular router navigation again if it is\n        // caused by a URL change from the current Angular router\n        // navigation.\n        const currentNavigationId = router.getCurrentNavigation()?.id;\n        const newStateNavigationId = newState?.navigationId;\n        if (newStateNavigationId !== undefined && newStateNavigationId === currentNavigationId) {\n          return;\n        }\n\n        let url;\n        if (urlType === 'path') {\n          url = resolveUrl(newUrl);\n        } else if (urlType === 'hash') {\n          // Remove the first hash from the URL\n          const hashIdx = newUrl.indexOf('#');\n          url = resolveUrl(newUrl.substring(0, hashIdx) + newUrl.substring(hashIdx + 1));\n        } else {\n          throw 'Invalid URLType passed to setUpLocationSync: ' + urlType;\n        }\n        const path = location.normalize(url.pathname);\n        router.navigateByUrl(path + url.search + url.hash);\n      },\n    );\n}\n\n/**\n * Normalizes and parses a URL.\n *\n * - Normalizing means that a relative URL will be resolved into an absolute URL in the context of\n *   the application document.\n * - Parsing means that the anchor's `protocol`, `hostname`, `port`, `pathname` and related\n *   properties are all populated to reflect the normalized URL.\n *\n * While this approach has wide compatibility, it doesn't work as expected on IE. On IE, normalizing\n * happens similar to other browsers, but the parsed components will not be set. (E.g. if you assign\n * `a.href = 'foo'`, then `a.protocol`, `a.host`, etc. will not be correctly updated.)\n * We work around that by performing the parsing in a 2nd step by taking a previously normalized URL\n * and assigning it again. This correctly populates all properties.\n *\n * See\n * https://github.com/angular/angular.js/blob/2c7400e7d07b0f6cec1817dab40b9250ce8ebce6/src/ng/urlUtils.js#L26-L33\n * for more info.\n */\nlet anchor: HTMLAnchorElement | undefined;\nfunction resolveUrl(url: string): {pathname: string; search: string; hash: string} {\n  anchor ??= document.createElement('a');\n\n  anchor.setAttribute('href', url);\n  anchor.setAttribute('href', anchor.href);\n\n  return {\n    // IE does not start `pathname` with `/` like other browsers.\n    pathname: `/${anchor.pathname.replace(/^\\//, '')}`,\n    search: anchor.search,\n    hash: anchor.hash,\n  };\n}\n"],"names":["RouterUpgradeInitializer","provide","APP_BOOTSTRAP_LISTENER","multi","useFactory","locationSyncBootstrapListener","ngUpgrade","inject","UpgradeModule","setUpLocationSync","urlType","$injector","Error","router","injector","get","Router","location","Location","$on","event","newUrl","oldUrl","newState","oldState","currentNavigationId","getCurrentNavigation","id","newStateNavigationId","navigationId","undefined","url","resolveUrl","hashIdx","indexOf","substring","path","normalize","pathname","navigateByUrl","search","hash","anchor","document","createElement","setAttribute","href","replace"],"mappings":";;;;;;;;;;;;;;AA4CO,MAAMA,wBAAwB,GAAG;AACtCC,EAAAA,OAAO,EAAEC,sBAAsB;AAC/BC,EAAAA,KAAK,EAAE,IAAI;AACXC,EAAAA,UAAU,EAAEC;;SAMEA,6BAA6BA,GAAA;AAC3C,EAAA,MAAMC,SAAS,GAAGC,MAAM,CAACC,aAAa,CAAC;AAEvC,EAAA,OAAO,MAAK;IACVC,iBAAiB,CAACH,SAAS,CAAC;GAC7B;AACH;SAcgBG,iBAAiBA,CAC/BH,SAAwB,EACxBI,UAA2B,MAAM,EAAA;AAEjC,EAAA,IAAI,CAACJ,SAAS,CAACK,SAAS,EAAE;IACxB,MAAM,IAAIC,KAAK,CAAC;;;AAGb,MAAA,CAAA,CAAC;AACN;EAEA,MAAMC,MAAM,GAAWP,SAAS,CAACQ,QAAQ,CAACC,GAAG,CAACC,MAAM,CAAC;EACrD,MAAMC,QAAQ,GAAaX,SAAS,CAACQ,QAAQ,CAACC,GAAG,CAACG,QAAQ,CAAC;EAE3DZ,SAAS,CAACK,SAAS,CAChBI,GAAG,CAAC,YAAY,CAAA,CAChBI,GAAG,CACF,sBAAsB,EACtB,CACEC,KAAU,EACVC,MAAc,EACdC,MAAc,EACdC,QAAiD,EACjDC,QAAiD,KAC/C;IAKF,MAAMC,mBAAmB,GAAGZ,MAAM,CAACa,oBAAoB,EAAE,EAAEC,EAAE;AAC7D,IAAA,MAAMC,oBAAoB,GAAGL,QAAQ,EAAEM,YAAY;AACnD,IAAA,IAAID,oBAAoB,KAAKE,SAAS,IAAIF,oBAAoB,KAAKH,mBAAmB,EAAE;AACtF,MAAA;AACF;AAEA,IAAA,IAAIM,GAAG;IACP,IAAIrB,OAAO,KAAK,MAAM,EAAE;AACtBqB,MAAAA,GAAG,GAAGC,UAAU,CAACX,MAAM,CAAC;AAC1B,KAAA,MAAO,IAAIX,OAAO,KAAK,MAAM,EAAE;AAE7B,MAAA,MAAMuB,OAAO,GAAGZ,MAAM,CAACa,OAAO,CAAC,GAAG,CAAC;MACnCH,GAAG,GAAGC,UAAU,CAACX,MAAM,CAACc,SAAS,CAAC,CAAC,EAAEF,OAAO,CAAC,GAAGZ,MAAM,CAACc,SAAS,CAACF,OAAO,GAAG,CAAC,CAAC,CAAC;AAChF,KAAA,MAAO;MACL,MAAM,+CAA+C,GAAGvB,OAAO;AACjE;IACA,MAAM0B,IAAI,GAAGnB,QAAQ,CAACoB,SAAS,CAACN,GAAG,CAACO,QAAQ,CAAC;AAC7CzB,IAAAA,MAAM,CAAC0B,aAAa,CAACH,IAAI,GAAGL,GAAG,CAACS,MAAM,GAAGT,GAAG,CAACU,IAAI,CAAC;AACpD,GAAC,CACF;AACL;AAoBA,IAAIC,MAAqC;AACzC,SAASV,UAAUA,CAACD,GAAW,EAAA;AAC7BW,EAAAA,MAAM,KAAKC,QAAQ,CAACC,aAAa,CAAC,GAAG,CAAC;AAEtCF,EAAAA,MAAM,CAACG,YAAY,CAAC,MAAM,EAAEd,GAAG,CAAC;EAChCW,MAAM,CAACG,YAAY,CAAC,MAAM,EAAEH,MAAM,CAACI,IAAI,CAAC;EAExC,OAAO;AAELR,IAAAA,QAAQ,EAAE,CAAA,CAAA,EAAII,MAAM,CAACJ,QAAQ,CAACS,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAE,CAAA;IAClDP,MAAM,EAAEE,MAAM,CAACF,MAAM;IACrBC,IAAI,EAAEC,MAAM,CAACD;GACd;AACH;;;;"}

package/package.json

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

package/types/_router_module-chunk.d.ts

@@ -1,5 +1,5 @@
 /**
- * @license Angular v21.0.0-next.9
+ * @license Angular v21.0.0-rc.1
  * (c) 2010-2025 Google LLC. https://angular.dev/
  * License: MIT
  */
@@ -3658,6 +3658,8 @@ type InitialNavigation = 'disabled' | 'enabledBlocking' | 'enabledNonBlocking';
 /**
  * Extra configuration options that can be used with the `withRouterConfig` function.
  *
+ * @see [Router configuration options](guide/routing/customizing-route-behavior#router-configuration-options)
+ *
  * @publicApi
  */
 interface RouterConfigOptions {
@@ -3681,6 +3683,9 @@ interface RouterConfigOptions {
      * the browser history rather than simply resetting a portion of the URL.
      *
      * The default value is `replace` when not set.
+     *
+     * @see [Handle canceled navigations](guide/routing/customizing-route-behavior#handle-canceled-navigations)
+     *
      */
     canceledNavigationResolution?: 'replace' | 'computed';
     /**
@@ -3689,6 +3694,8 @@ interface RouterConfigOptions {
      * If unset, the `Router` will use `'ignore'`.
      *
      * @see {@link OnSameUrlNavigation}
+     *
+     * @see [React to same-URL navigations](guide/routing/customizing-route-behavior#react-to-same-url-navigations)
      */
     onSameUrlNavigation?: OnSameUrlNavigation;
     /**
@@ -3707,6 +3714,8 @@ interface RouterConfigOptions {
      * matrix parameters for `{path: 'a/b', component: MyComp}` should appear as `a/b;foo=bar` and not
      * `a;foo=bar/b`.
      *
+     * @see [Control parameter inheritance](guide/routing/customizing-route-behavior#control-parameter-inheritance)
+     *
      */
     paramsInheritanceStrategy?: 'emptyOnly' | 'always';
     /**
@@ -3715,6 +3724,9 @@ interface RouterConfigOptions {
      * Set to 'eager' if prefer to update the URL at the beginning of navigation.
      * Updating the URL early allows you to handle a failure of navigation by
      * showing an error message with the URL that failed.
+     *
+     * @see [Decide when the URL updates](guide/routing/customizing-route-behavior#decide-when-the-url-updates)
+     *
      */
     urlUpdateStrategy?: 'deferred' | 'eager';
     /**
@@ -3728,6 +3740,10 @@ interface RouterConfigOptions {
      *
      * @see {@link Router#createUrlTree}
      * @see {@link QueryParamsHandling}
+     *
+     * @see [Choose default query parameter handling](guide/routing/customizing-route-behavior#choose-default-query-parameter-handling)
+  
+     *
      */
     defaultQueryParamsHandling?: QueryParamsHandling;
     /**

package/types/router.d.ts

@@ -1,5 +1,5 @@
 /**
- * @license Angular v21.0.0-next.9
+ * @license Angular v21.0.0-rc.1
  * (c) 2010-2025 Google LLC. https://angular.dev/
  * License: MIT
  */
@@ -336,6 +336,7 @@ declare class RouterPreloader implements OnDestroy {
  *   }
  * );
  * ```
+ * @see [Router](guide/routing)
  *
  * @see {@link RouterFeatures}
  *
@@ -407,6 +408,32 @@ type InMemoryScrollingFeature = RouterFeature<RouterFeatureKind.InMemoryScrollin
  * @returns A set of providers for use with `provideRouter`.
  */
 declare function withInMemoryScrolling(options?: InMemoryScrollingOptions): InMemoryScrollingFeature;
+/**
+ * Enables the use of the browser's `History` API for navigation.
+ *
+ * @description
+ * This function provides a `Location` strategy that uses the browser's `History` API.
+ * It is required when using features that rely on `history.state`. For example, the
+ * `state` object in `NavigationExtras` is passed to `history.pushState` or
+ * `history.replaceState`.
+ *
+ * @usageNotes
+ *
+ * ```typescript
+ * const appRoutes: Routes = [
+ *   { path: 'page', component: PageComponent },
+ * ];
+ *
+ * bootstrapApplication(AppComponent, {
+ *   providers: [
+ *     provideRouter(appRoutes, withPlatformNavigation())
+ *   ]
+ * });
+ * ```
+ *
+ * @returns A `RouterFeature` that enables the platform navigation.
+ */
+declare function withPlatformNavigation(): RouterFeature<RouterFeatureKind.InMemoryScrollingFeature>;
 /**
  * A type alias for providers returned by `withEnabledBlockingInitialNavigation` for use with
  * `provideRouter`.
@@ -901,5 +928,5 @@ declare function afterNextNavigation(router: {
  */
 declare function provideSometimesSyncRecognize(): EnvironmentProviders;
 
-export { ActivatedRoute, ActivatedRouteSnapshot, CanActivate, CanActivateChild, CanActivateChildFn, CanActivateFn, CanDeactivate, CanDeactivateFn, CanMatch, CanMatchFn, ChildrenOutletContexts, DefaultTitleStrategy, DefaultUrlSerializer, Event, InMemoryScrollingOptions, NavigationError, NoPreloading, OutletContext, Params, PreloadAllModules, PreloadingStrategy, ROUTES, RedirectCommand, Resolve, ResolveFn, Route, Router, RouterConfigOptions, RouterOutletContract, RouterPreloader, RouterStateSnapshot, Routes, TitleStrategy, UrlHandlingStrategy, UrlTree, VERSION, createUrlTreeFromSnapshot, mapToCanActivate, mapToCanActivateChild, mapToCanDeactivate, mapToCanMatch, mapToResolve, provideRouter, provideRoutes, withComponentInputBinding, withDebugTracing, withDisabledInitialNavigation, withEnabledBlockingInitialNavigation, withHashLocation, withInMemoryScrolling, withNavigationErrorHandler, withPreloading, withRouterConfig, withViewTransitions, afterNextNavigation as ɵafterNextNavigation, loadChildren as ɵloadChildren, provideSometimesSyncRecognize as ɵprovideSometimesSyncRecognize };
+export { ActivatedRoute, ActivatedRouteSnapshot, CanActivate, CanActivateChild, CanActivateChildFn, CanActivateFn, CanDeactivate, CanDeactivateFn, CanMatch, CanMatchFn, ChildrenOutletContexts, DefaultTitleStrategy, DefaultUrlSerializer, Event, InMemoryScrollingOptions, NavigationError, NoPreloading, OutletContext, Params, PreloadAllModules, PreloadingStrategy, ROUTES, RedirectCommand, Resolve, ResolveFn, Route, Router, RouterConfigOptions, RouterOutletContract, RouterPreloader, RouterStateSnapshot, Routes, TitleStrategy, UrlHandlingStrategy, UrlTree, VERSION, createUrlTreeFromSnapshot, mapToCanActivate, mapToCanActivateChild, mapToCanDeactivate, mapToCanMatch, mapToResolve, provideRouter, provideRoutes, withComponentInputBinding, withDebugTracing, withDisabledInitialNavigation, withEnabledBlockingInitialNavigation, withHashLocation, withInMemoryScrolling, withNavigationErrorHandler, withPreloading, withRouterConfig, withViewTransitions, afterNextNavigation as ɵafterNextNavigation, loadChildren as ɵloadChildren, provideSometimesSyncRecognize as ɵprovideSometimesSyncRecognize, withPlatformNavigation as ɵwithPlatformNavigation };
 export type { ComponentInputBindingFeature, DebugTracingFeature, DisabledInitialNavigationFeature, EnabledBlockingInitialNavigationFeature, InMemoryScrollingFeature, InitialNavigationFeature, NavigationErrorHandlerFeature, PreloadingFeature, RouterConfigurationFeature, RouterFeature, RouterFeatures, RouterHashLocationFeature, ViewTransitionInfo, ViewTransitionsFeature, ViewTransitionsFeatureOptions };

package/types/testing.d.ts

@@ -1,5 +1,5 @@
 /**
- * @license Angular v21.0.0-next.9
+ * @license Angular v21.0.0-rc.1
  * (c) 2010-2025 Google LLC. https://angular.dev/
  * License: MIT
  */

package/types/upgrade.d.ts

@@ -1,5 +1,5 @@
 /**
- * @license Angular v21.0.0-next.9
+ * @license Angular v21.0.0-rc.1
  * (c) 2010-2025 Google LLC. https://angular.dev/
  * License: MIT
  */