@angular/router 21.1.0-next.4 → 21.1.0

package/types/router.d.ts

@@ -1,17 +1,61 @@
 /**
- * @license Angular v21.1.0-next.4
- * (c) 2010-2025 Google LLC. https://angular.dev/
+ * @license Angular v21.1.0
+ * (c) 2010-2026 Google LLC. https://angular.dev/
  * License: MIT
  */
 
-import { ActivatedRouteSnapshot, Params, DefaultUrlSerializer, UrlTree, RouterOutletContract, ActivatedRoute, RouterStateSnapshot, Route, LoadedRouterConfig, Router, Routes, InMemoryScrollingOptions, RouterConfigOptions, NavigationError, RedirectCommand, CanMatch, CanMatchFn, CanActivate, CanActivateFn, CanActivateChild, CanActivateChildFn, CanDeactivate, CanDeactivateFn, Resolve, ResolveFn, Event } from './_router_module-chunk.js';
-export { ActivationEnd, ActivationStart, BaseRouteReuseStrategy, CanLoad, CanLoadFn, ChildActivationEnd, ChildActivationStart, Data, DefaultExport, DeprecatedGuard, DeprecatedResolve, DetachedRouteHandle, EventType, ExtraOptions, GuardResult, GuardsCheckEnd, GuardsCheckStart, InitialNavigation, IsActiveMatchOptions, LoadChildren, LoadChildrenCallback, MaybeAsync, Navigation, NavigationBehaviorOptions, NavigationCancel, NavigationCancellationCode, NavigationEnd, NavigationExtras, NavigationSkipped, NavigationSkippedCode, NavigationStart, OnSameUrlNavigation, PRIMARY_OUTLET, ParamMap, QueryParamsHandling, ROUTER_CONFIGURATION, ROUTER_INITIALIZER, ROUTER_OUTLET_DATA, RedirectFunction, ResolveData, ResolveEnd, ResolveStart, RouteConfigLoadEnd, RouteConfigLoadStart, RouteReuseStrategy, RouterEvent, RouterLink, RouterLinkActive, RouterLink as RouterLinkWithHref, RouterModule, RouterOutlet, RouterState, RoutesRecognized, RunGuardsAndResolvers, Scroll, UrlCreationOptions, UrlMatchResult, UrlMatcher, UrlSegment, UrlSegmentGroup, UrlSerializer, convertToParamMap, defaultUrlMatcher, ɵEmptyOutletComponent, ROUTER_PROVIDERS as ɵROUTER_PROVIDERS, RestoredState as ɵRestoredState } from './_router_module-chunk.js';
+import { RouterOutletContract, ActivatedRoute, ActivatedRouteSnapshot, Params, DefaultUrlSerializer, UrlTree, RouterStateSnapshot, Route, LoadedRouterConfig, Router, Routes, InMemoryScrollingOptions, RouterConfigOptions, NavigationError, RedirectCommand, CanMatch, CanMatchFn, CanActivate, CanActivateFn, CanActivateChild, CanActivateChildFn, CanDeactivate, CanDeactivateFn, Resolve, ResolveFn, Event } from './_router_module-chunk.js';
+export { ActivationEnd, ActivationStart, BaseRouteReuseStrategy, CanLoad, CanLoadFn, ChildActivationEnd, ChildActivationStart, Data, DefaultExport, DeprecatedGuard, DeprecatedResolve, DetachedRouteHandle, EventType, ExtraOptions, GuardResult, GuardsCheckEnd, GuardsCheckStart, InitialNavigation, IsActiveMatchOptions, LoadChildren, LoadChildrenCallback, MaybeAsync, Navigation, NavigationBehaviorOptions, NavigationCancel, NavigationCancellationCode, NavigationEnd, NavigationExtras, NavigationSkipped, NavigationSkippedCode, NavigationStart, OnSameUrlNavigation, PRIMARY_OUTLET, ParamMap, QueryParamsHandling, ROUTER_CONFIGURATION, ROUTER_INITIALIZER, ROUTER_OUTLET_DATA, RedirectFunction, ResolveData, ResolveEnd, ResolveStart, RouteConfigLoadEnd, RouteConfigLoadStart, RouteReuseStrategy, RouterEvent, RouterLink, RouterLinkActive, RouterLink as RouterLinkWithHref, RouterModule, RouterOutlet, RouterState, RoutesRecognized, RunGuardsAndResolvers, Scroll, UrlCreationOptions, UrlMatchResult, UrlMatcher, UrlSegment, UrlSegmentGroup, UrlSerializer, convertToParamMap, defaultUrlMatcher, destroyDetachedRouteHandle, isActive, ɵEmptyOutletComponent, ROUTER_PROVIDERS as ɵROUTER_PROVIDERS, RestoredState as ɵRestoredState } from './_router_module-chunk.js';
 import { Title } from '@angular/platform-browser';
 import * as i0 from '@angular/core';
 import { ComponentRef, EnvironmentInjector, InjectionToken, Compiler, Injector, Type, OnDestroy, EnvironmentProviders, Provider, Version } from '@angular/core';
 import { Observable } from 'rxjs';
 import '@angular/common';
 
+/**
+ * Store contextual information about a `RouterOutlet`
+ *
+ * @publicApi
+ */
+declare class OutletContext {
+    private readonly rootInjector;
+    outlet: RouterOutletContract | null;
+    route: ActivatedRoute | null;
+    children: ChildrenOutletContexts;
+    attachRef: ComponentRef<any> | null;
+    get injector(): EnvironmentInjector;
+    constructor(rootInjector: EnvironmentInjector);
+}
+/**
+ * Store contextual information about the children (= nested) `RouterOutlet`
+ *
+ * @publicApi
+ */
+declare class ChildrenOutletContexts {
+    private rootInjector;
+    private contexts;
+    /** @docs-private */
+    constructor(rootInjector: EnvironmentInjector);
+    /** Called when a `RouterOutlet` directive is instantiated */
+    onChildOutletCreated(childName: string, outlet: RouterOutletContract): void;
+    /**
+     * Called when a `RouterOutlet` directive is destroyed.
+     * We need to keep the context as the outlet could be destroyed inside a NgIf and might be
+     * re-created later.
+     */
+    onChildOutletDestroyed(childName: string): void;
+    /**
+     * Called when the corresponding route is deactivated during navigation.
+     * Because the component get destroyed, all children outlet are destroyed.
+     */
+    onOutletDeactivated(): Map<string, OutletContext>;
+    onOutletReAttached(contexts: Map<string, OutletContext>): void;
+    getOrCreateContext(childName: string): OutletContext;
+    getContext(childName: string): OutletContext | null;
+    static ɵfac: i0.ɵɵFactoryDeclaration<ChildrenOutletContexts, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<ChildrenOutletContexts>;
+}
+
 /**
  * Creates a `UrlTree` relative to an `ActivatedRouteSnapshot`.
  *
@@ -68,50 +112,6 @@ import '@angular/common';
  */
 declare function createUrlTreeFromSnapshot(relativeTo: ActivatedRouteSnapshot, commands: readonly any[], queryParams?: Params | null, fragment?: string | null, urlSerializer?: DefaultUrlSerializer): UrlTree;
 
-/**
- * Store contextual information about a `RouterOutlet`
- *
- * @publicApi
- */
-declare class OutletContext {
-    private readonly rootInjector;
-    outlet: RouterOutletContract | null;
-    route: ActivatedRoute | null;
-    children: ChildrenOutletContexts;
-    attachRef: ComponentRef<any> | null;
-    get injector(): EnvironmentInjector;
-    constructor(rootInjector: EnvironmentInjector);
-}
-/**
- * Store contextual information about the children (= nested) `RouterOutlet`
- *
- * @publicApi
- */
-declare class ChildrenOutletContexts {
-    private rootInjector;
-    private contexts;
-    /** @docs-private */
-    constructor(rootInjector: EnvironmentInjector);
-    /** Called when a `RouterOutlet` directive is instantiated */
-    onChildOutletCreated(childName: string, outlet: RouterOutletContract): void;
-    /**
-     * Called when a `RouterOutlet` directive is destroyed.
-     * We need to keep the context as the outlet could be destroyed inside a NgIf and might be
-     * re-created later.
-     */
-    onChildOutletDestroyed(childName: string): void;
-    /**
-     * Called when the corresponding route is deactivated during navigation.
-     * Because the component get destroyed, all children outlet are destroyed.
-     */
-    onOutletDeactivated(): Map<string, OutletContext>;
-    onOutletReAttached(contexts: Map<string, OutletContext>): void;
-    getOrCreateContext(childName: string): OutletContext;
-    getContext(childName: string): OutletContext | null;
-    static ɵfac: i0.ɵɵFactoryDeclaration<ChildrenOutletContexts, never>;
-    static ɵprov: i0.ɵɵInjectableDeclaration<ChildrenOutletContexts>;
-}
-
 /**
  * Options to configure the View Transitions integration in the Router.
  *
@@ -426,13 +426,34 @@ type InMemoryScrollingFeature = RouterFeature<RouterFeatureKind.InMemoryScrollin
  */
 declare function withInMemoryScrolling(options?: InMemoryScrollingOptions): InMemoryScrollingFeature;
 /**
- * Enables the use of the browser's `History` API for navigation.
+ * A type alias for providers returned by `withExperimentalPlatformNavigation` for use with `provideRouter`.
+ *
+ * @see {@link withExperimentalPlatformNavigation}
+ * @see {@link provideRouter}
+ *
+ * @experimental 21.1
+ */
+type ExperimentalPlatformNavigationFeature = RouterFeature<RouterFeatureKind.ExperimentalPlatformNavigationFeature>;
+/**
+ * Enables interop with the browser's `Navigation` API for router navigations.
  *
  * @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`.
+ *
+ * CRITICAL: This feature is _highly_ experimental and should not be used in production. Browser support
+ * is limited and in active development. Use only for experimentation and feedback purposes.
+ *
+ * This function provides a `Location` strategy that uses the browser's `Navigation` API.
+ * By using the platform's Navigation APIs, the Router is able to provide native
+ * browser navigation capabilities. Some advantages include:
+ *
+ * - The ability to intercept navigations triggered outside the Router. This allows plain anchor
+ * elements _without_ `RouterLink` directives to be intercepted by the Router and converted to SPA navigations.
+ * - Native scroll and focus restoration support by the browser, without the need for custom implementations.
+ * - Communication of ongoing navigations to the browser, enabling built-in features like
+ * accessibility announcements, loading indicators, stop buttons, and performance measurement APIs.
+
+ * NOTE: Deferred entry updates are not part of the interop 2025 Navigation API commitments so the "ongoing navigation"
+ * communication support is limited.
  *
  * @usageNotes
  *
@@ -443,14 +464,19 @@ declare function withInMemoryScrolling(options?: InMemoryScrollingOptions): InMe
  *
  * bootstrapApplication(AppComponent, {
  *   providers: [
- *     provideRouter(appRoutes, withPlatformNavigation())
+ *     provideRouter(appRoutes, withExperimentalPlatformNavigation())
  *   ]
  * });
  * ```
  *
+ * @see https://github.com/WICG/navigation-api?tab=readme-ov-file#problem-statement
+ * @see https://developer.chrome.com/docs/web-platform/navigation-api/
+ * @see https://developer.mozilla.org/en-US/docs/Web/API/Navigation_API
+ *
+ * @experimental 21.1
  * @returns A `RouterFeature` that enables the platform navigation.
  */
-declare function withPlatformNavigation(): RouterFeature<RouterFeatureKind.InMemoryScrollingFeature>;
+declare function withExperimentalPlatformNavigation(): ExperimentalPlatformNavigationFeature;
 /**
  * A type alias for providers returned by `withEnabledBlockingInitialNavigation` for use with
  * `provideRouter`.
@@ -728,6 +754,30 @@ type NavigationErrorHandlerFeature = RouterFeature<RouterFeatureKind.NavigationE
  * @publicApi
  */
 declare function withNavigationErrorHandler(handler: (error: NavigationError) => unknown | RedirectCommand): NavigationErrorHandlerFeature;
+/**
+ * A type alias for providers returned by `withExperimentalAutoCleanupInjectors` for use with `provideRouter`.
+ *
+ * @see {@link withExperimentalAutoCleanupInjectors}
+ * @see {@link provideRouter}
+ *
+ * @experimental 21.1
+ */
+type ExperimentalAutoCleanupInjectorsFeature = RouterFeature<RouterFeatureKind.ExperimentalAutoCleanupInjectorsFeature>;
+/**
+ * Enables automatic destruction of unused route injectors.
+ *
+ * @description
+ *
+ * When enabled, the router will automatically destroy `EnvironmentInjector`s associated with `Route`s
+ * that are no longer active or stored by the `RouteReuseStrategy`.
+ *
+ * This feature is opt-in and requires `RouteReuseStrategy.shouldDestroyInjector` to return `true`
+ * for the routes that should be destroyed. If the `RouteReuseStrategy` uses stored handles, it
+ * should also implement `retrieveStoredHandle` to ensure we don't destroy injectors for handles that will be reattached.
+ *
+ * @experimental 21.1
+ */
+declare function withExperimentalAutoCleanupInjectors(): ExperimentalAutoCleanupInjectorsFeature;
 /**
  * A type alias for providers returned by `withComponentInputBinding` for use with `provideRouter`.
  *
@@ -824,7 +874,7 @@ declare function withViewTransitions(options?: ViewTransitionsFeatureOptions): V
  *
  * @publicApi
  */
-type RouterFeatures = PreloadingFeature | DebugTracingFeature | InitialNavigationFeature | InMemoryScrollingFeature | RouterConfigurationFeature | NavigationErrorHandlerFeature | ComponentInputBindingFeature | ViewTransitionsFeature | RouterHashLocationFeature;
+type RouterFeatures = PreloadingFeature | DebugTracingFeature | InitialNavigationFeature | InMemoryScrollingFeature | RouterConfigurationFeature | NavigationErrorHandlerFeature | ComponentInputBindingFeature | ViewTransitionsFeature | ExperimentalAutoCleanupInjectorsFeature | RouterHashLocationFeature | ExperimentalPlatformNavigationFeature;
 /**
  * The list of features as an enum to uniquely type each feature.
  */
@@ -838,7 +888,9 @@ declare const enum RouterFeatureKind {
     RouterHashLocationFeature = 6,
     NavigationErrorHandlerFeature = 7,
     ComponentInputBindingFeature = 8,
-    ViewTransitionsFeature = 9
+    ViewTransitionsFeature = 9,
+    ExperimentalAutoCleanupInjectorsFeature = 10,
+    ExperimentalPlatformNavigationFeature = 11
 }
 
 /**
@@ -948,10 +1000,5 @@ declare function afterNextNavigation(router: {
     events: Observable<Event>;
 }, action: () => void): void;
 
-/**
- * Provides a way to use the synchronous version of the recognize function using rxjs.
- */
-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, withPlatformNavigation as ɵwithPlatformNavigation };
+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, withExperimentalAutoCleanupInjectors, withExperimentalPlatformNavigation, withHashLocation, withInMemoryScrolling, withNavigationErrorHandler, withPreloading, withRouterConfig, withViewTransitions, afterNextNavigation as ɵafterNextNavigation, loadChildren as ɵloadChildren };
 export type { ComponentInputBindingFeature, DebugTracingFeature, DisabledInitialNavigationFeature, EnabledBlockingInitialNavigationFeature, InMemoryScrollingFeature, InitialNavigationFeature, NavigationErrorHandlerFeature, PreloadingFeature, RouterConfigurationFeature, RouterFeature, RouterFeatures, RouterHashLocationFeature, ViewTransitionInfo, ViewTransitionsFeature, ViewTransitionsFeatureOptions };

package/types/testing.d.ts

@@ -1,6 +1,6 @@
 /**
- * @license Angular v21.1.0-next.4
- * (c) 2010-2025 Google LLC. https://angular.dev/
+ * @license Angular v21.1.0
+ * (c) 2010-2026 Google LLC. https://angular.dev/
  * License: MIT
  */
 

package/types/upgrade.d.ts

@@ -1,6 +1,6 @@
 /**
- * @license Angular v21.1.0-next.4
- * (c) 2010-2025 Google LLC. https://angular.dev/
+ * @license Angular v21.1.0
+ * (c) 2010-2026 Google LLC. https://angular.dev/
  * License: MIT
  */