@angular/common 20.0.0-next.0 → 20.0.0-next.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@angular/common",
-  "version": "20.0.0-next.0",
+  "version": "20.0.0-next.2",
   "description": "Angular - commonly needed directives and services",
   "author": "angular",
   "license": "MIT",
@@ -44,7 +44,7 @@
     }
   },
   "peerDependencies": {
-    "@angular/core": "20.0.0-next.0",
+    "@angular/core": "20.0.0-next.2",
     "rxjs": "^6.5.3 || ^7.4.0"
   },
   "repository": {

package/testing/index.d.ts

@@ -1,26 +1,51 @@
 /**
- * @license Angular v20.0.0-next.0
- * (c) 2010-2024 Google LLC. https://angular.io/
+ * @license Angular v20.0.0-next.2
+ * (c) 2010-2025 Google LLC. https://angular.io/
  * License: MIT
  */
 
-
 import * as i0 from '@angular/core';
-import { InjectionToken } from '@angular/core';
-import { Location as Location_2 } from '@angular/common';
-import { LocationChangeListener } from '@angular/common';
-import { LocationStrategy } from '@angular/common';
-import { PlatformLocation } from '@angular/common';
-import { Provider } from '@angular/core';
+import { Provider, InjectionToken } from '@angular/core';
+export { ɵFakeNavigation } from '@angular/core/testing';
+import { Location, LocationStrategy, PlatformLocation, LocationChangeListener } from '@angular/common';
 import { SubscriptionLike } from 'rxjs';
-import { ɵFakeNavigation } from '@angular/core/testing';
 
 /**
- * Provider for mock platform location config
+ * Return a provider for the `FakeNavigation` in place of the real Navigation API.
+ */
+declare function provideFakePlatformNavigation(): Provider[];
+
+/**
+ * A spy for {@link Location} that allows tests to fire simulated location events.
  *
  * @publicApi
  */
-export declare const MOCK_PLATFORM_LOCATION_CONFIG: InjectionToken<MockPlatformLocationConfig>;
+declare class SpyLocation implements Location {
+    urlChanges: string[];
+    private _history;
+    private _historyIndex;
+    /** @nodoc */
+    ngOnDestroy(): void;
+    setInitialPath(url: string): void;
+    setBaseHref(url: string): void;
+    path(): string;
+    getState(): unknown;
+    isCurrentPathEqualTo(path: string, query?: string): boolean;
+    simulateUrlPop(pathname: string): void;
+    simulateHashChange(pathname: string): void;
+    prepareExternalUrl(url: string): string;
+    go(path: string, query?: string, state?: any): void;
+    replaceState(path: string, query?: string, state?: any): void;
+    forward(): void;
+    back(): void;
+    historyGo(relativePosition?: number): void;
+    onUrlChange(fn: (url: string, state: unknown) => void): VoidFunction;
+    subscribe(onNext: (value: any) => void, onThrow?: ((error: any) => void) | null, onReturn?: (() => void) | null): SubscriptionLike;
+    normalize(url: string): string;
+    private pushHistory;
+    static ɵfac: i0.ɵɵFactoryDeclaration<SpyLocation, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<SpyLocation>;
+}
 
 /**
  * A mock implementation of {@link LocationStrategy} that allows tests to fire simulated
@@ -28,7 +53,7 @@ export declare const MOCK_PLATFORM_LOCATION_CONFIG: InjectionToken<MockPlatformL
  *
  * @publicApi
  */
-export declare class MockLocationStrategy extends LocationStrategy {
+declare class MockLocationStrategy extends LocationStrategy {
     internalBaseHref: string;
     internalPath: string;
     internalTitle: string;
@@ -49,12 +74,27 @@ export declare class MockLocationStrategy extends LocationStrategy {
     static ɵprov: i0.ɵɵInjectableDeclaration<MockLocationStrategy>;
 }
 
+/**
+ * Mock platform location config
+ *
+ * @publicApi
+ */
+interface MockPlatformLocationConfig {
+    startUrl?: string;
+    appBaseHref?: string;
+}
+/**
+ * Provider for mock platform location config
+ *
+ * @publicApi
+ */
+declare const MOCK_PLATFORM_LOCATION_CONFIG: InjectionToken<MockPlatformLocationConfig>;
 /**
  * Mock implementation of URL state.
  *
  * @publicApi
  */
-export declare class MockPlatformLocation implements PlatformLocation {
+declare class MockPlatformLocation implements PlatformLocation {
     private baseHref;
     private hashUpdate;
     private popStateSubject;
@@ -95,61 +135,12 @@ export declare class MockPlatformLocation implements PlatformLocation {
     static ɵprov: i0.ɵɵInjectableDeclaration<MockPlatformLocation>;
 }
 
-/**
- * Mock platform location config
- *
- * @publicApi
- */
-export declare interface MockPlatformLocationConfig {
-    startUrl?: string;
-    appBaseHref?: string;
-}
-
 /**
  * Returns mock providers for the `Location` and `LocationStrategy` classes.
  * The mocks are helpful in tests to fire simulated location events.
  *
  * @publicApi
  */
-export declare function provideLocationMocks(): Provider[];
-
-/**
- * A spy for {@link Location} that allows tests to fire simulated location events.
- *
- * @publicApi
- */
-export declare class SpyLocation implements Location_2 {
-    urlChanges: string[];
-    private _history;
-    private _historyIndex;
-    /** @nodoc */
-    ngOnDestroy(): void;
-    setInitialPath(url: string): void;
-    setBaseHref(url: string): void;
-    path(): string;
-    getState(): unknown;
-    isCurrentPathEqualTo(path: string, query?: string): boolean;
-    simulateUrlPop(pathname: string): void;
-    simulateHashChange(pathname: string): void;
-    prepareExternalUrl(url: string): string;
-    go(path: string, query?: string, state?: any): void;
-    replaceState(path: string, query?: string, state?: any): void;
-    forward(): void;
-    back(): void;
-    historyGo(relativePosition?: number): void;
-    onUrlChange(fn: (url: string, state: unknown) => void): VoidFunction;
-    subscribe(onNext: (value: any) => void, onThrow?: ((error: any) => void) | null, onReturn?: (() => void) | null): SubscriptionLike;
-    normalize(url: string): string;
-    private pushHistory;
-    static ɵfac: i0.ɵɵFactoryDeclaration<SpyLocation, never>;
-    static ɵprov: i0.ɵɵInjectableDeclaration<SpyLocation>;
-}
-
-export { ɵFakeNavigation }
-
-/**
- * Return a provider for the `FakeNavigation` in place of the real Navigation API.
- */
-export declare function ɵprovideFakePlatformNavigation(): Provider[];
+declare function provideLocationMocks(): Provider[];
 
-export { }
+export { MOCK_PLATFORM_LOCATION_CONFIG, MockLocationStrategy, MockPlatformLocation, type MockPlatformLocationConfig, SpyLocation, provideLocationMocks, provideFakePlatformNavigation as ɵprovideFakePlatformNavigation };

package/upgrade/index.d.ts

@@ -1,18 +1,134 @@
 /**
- * @license Angular v20.0.0-next.0
- * (c) 2010-2024 Google LLC. https://angular.io/
+ * @license Angular v20.0.0-next.2
+ * (c) 2010-2025 Google LLC. https://angular.io/
  * License: MIT
  */
 
-
-import * as i0 from '@angular/core';
 import * as i1 from '@angular/common';
-import { InjectionToken } from '@angular/core';
-import { Location as Location_2 } from '@angular/common';
-import { LocationStrategy } from '@angular/common';
-import { ModuleWithProviders } from '@angular/core';
-import { PlatformLocation } from '@angular/common';
+import { Location, PlatformLocation, LocationStrategy } from '@angular/common';
 import { UpgradeModule } from '@angular/upgrade/static';
+import * as i0 from '@angular/core';
+import { InjectionToken, ModuleWithProviders } from '@angular/core';
+
+/**
+ * A codec for encoding and decoding URL parts.
+ *
+ * @publicApi
+ **/
+declare abstract class UrlCodec {
+    /**
+     * Encodes the path from the provided string
+     *
+     * @param path The path string
+     */
+    abstract encodePath(path: string): string;
+    /**
+     * Decodes the path from the provided string
+     *
+     * @param path The path string
+     */
+    abstract decodePath(path: string): string;
+    /**
+     * Encodes the search string from the provided string or object
+     *
+     * @param path The path string or object
+     */
+    abstract encodeSearch(search: string | {
+        [k: string]: unknown;
+    }): string;
+    /**
+     * Decodes the search objects from the provided string
+     *
+     * @param path The path string
+     */
+    abstract decodeSearch(search: string): {
+        [k: string]: unknown;
+    };
+    /**
+     * Encodes the hash from the provided string
+     *
+     * @param path The hash string
+     */
+    abstract encodeHash(hash: string): string;
+    /**
+     * Decodes the hash from the provided string
+     *
+     * @param path The hash string
+     */
+    abstract decodeHash(hash: string): string;
+    /**
+     * Normalizes the URL from the provided string
+     *
+     * @param path The URL string
+     */
+    abstract normalize(href: string): string;
+    /**
+     * Normalizes the URL from the provided string, search, hash, and base URL parameters
+     *
+     * @param path The URL path
+     * @param search The search object
+     * @param hash The has string
+     * @param baseUrl The base URL for the URL
+     */
+    abstract normalize(path: string, search: {
+        [k: string]: unknown;
+    }, hash: string, baseUrl?: string): string;
+    /**
+     * Checks whether the two strings are equal
+     * @param valA First string for comparison
+     * @param valB Second string for comparison
+     */
+    abstract areEqual(valA: string, valB: string): boolean;
+    /**
+     * Parses the URL string based on the base URL
+     *
+     * @param url The full URL string
+     * @param base The base for the URL
+     */
+    abstract parse(url: string, base?: string): {
+        href: string;
+        protocol: string;
+        host: string;
+        search: string;
+        hash: string;
+        hostname: string;
+        port: string;
+        pathname: string;
+    };
+}
+/**
+ * A `UrlCodec` that uses logic from AngularJS to serialize and parse URLs
+ * and URL parameters.
+ *
+ * @publicApi
+ */
+declare class AngularJSUrlCodec implements UrlCodec {
+    encodePath(path: string): string;
+    encodeSearch(search: string | {
+        [k: string]: unknown;
+    }): string;
+    encodeHash(hash: string): string;
+    decodePath(path: string, html5Mode?: boolean): string;
+    decodeSearch(search: string): {
+        [k: string]: unknown;
+    };
+    decodeHash(hash: string): string;
+    normalize(href: string): string;
+    normalize(path: string, search: {
+        [k: string]: unknown;
+    }, hash: string, baseUrl?: string): string;
+    areEqual(valA: string, valB: string): boolean;
+    parse(url: string, base?: string): {
+        href: string;
+        protocol: string;
+        host: string;
+        search: string;
+        hash: string;
+        hostname: string;
+        port: string;
+        pathname: string;
+    };
+}
 
 /**
  * Location service that provides a drop-in replacement for the $location service
@@ -22,7 +138,7 @@ import { UpgradeModule } from '@angular/upgrade/static';
  *
  * @publicApi
  */
-export declare class $locationShim {
+declare class $locationShim {
     private location;
     private platformLocation;
     private urlCodec;
@@ -42,7 +158,8 @@ export declare class $locationShim {
     private $$changeListeners;
     private cachedState;
     private urlChanges;
-    constructor($injector: any, location: Location_2, platformLocation: PlatformLocation, urlCodec: UrlCodec, locationStrategy: LocationStrategy);
+    private readonly removeOnUrlChangeFn;
+    constructor($injector: any, location: Location, platformLocation: PlatformLocation, urlCodec: UrlCodec, locationStrategy: LocationStrategy);
     private initialize;
     private resetBrowserUpdate;
     private lastHistoryState;
@@ -245,20 +362,19 @@ export declare class $locationShim {
     state(): unknown;
     state(state: unknown): this;
 }
-
 /**
  * The factory function used to create an instance of the `$locationShim` in Angular,
  * and provides an API-compatible `$locationProvider` for AngularJS.
  *
  * @publicApi
  */
-export declare class $locationShimProvider {
+declare class $locationShimProvider {
     private ngUpgrade;
     private location;
     private platformLocation;
     private urlCodec;
     private locationStrategy;
-    constructor(ngUpgrade: UpgradeModule, location: Location_2, platformLocation: PlatformLocation, urlCodec: UrlCodec, locationStrategy: LocationStrategy);
+    constructor(ngUpgrade: UpgradeModule, location: Location, platformLocation: PlatformLocation, urlCodec: UrlCodec, locationStrategy: LocationStrategy);
     /**
      * Factory method that returns an instance of the $locationShim
      */
@@ -275,53 +391,12 @@ export declare class $locationShimProvider {
     html5Mode(mode?: any): void;
 }
 
-/**
- * A `UrlCodec` that uses logic from AngularJS to serialize and parse URLs
- * and URL parameters.
- *
- * @publicApi
- */
-export declare class AngularJSUrlCodec implements UrlCodec {
-    encodePath(path: string): string;
-    encodeSearch(search: string | {
-        [k: string]: unknown;
-    }): string;
-    encodeHash(hash: string): string;
-    decodePath(path: string, html5Mode?: boolean): string;
-    decodeSearch(search: string): {
-        [k: string]: unknown;
-    };
-    decodeHash(hash: string): string;
-    normalize(href: string): string;
-    normalize(path: string, search: {
-        [k: string]: unknown;
-    }, hash: string, baseUrl?: string): string;
-    areEqual(valA: string, valB: string): boolean;
-    parse(url: string, base?: string): {
-        href: string;
-        protocol: string;
-        host: string;
-        search: string;
-        hash: string;
-        hostname: string;
-        port: string;
-        pathname: string;
-    };
-}
-
-/**
- * A provider token used to configure the location upgrade module.
- *
- * @publicApi
- */
-export declare const LOCATION_UPGRADE_CONFIGURATION: InjectionToken<LocationUpgradeConfig>;
-
 /**
  * Configuration options for LocationUpgrade.
  *
  * @publicApi
  */
-export declare interface LocationUpgradeConfig {
+interface LocationUpgradeConfig {
     /**
      * Configures whether the location upgrade module should use the `HashLocationStrategy`
      * or the `PathLocationStrategy`
@@ -344,7 +419,12 @@ export declare interface LocationUpgradeConfig {
      */
     appBaseHref?: string;
 }
-
+/**
+ * A provider token used to configure the location upgrade module.
+ *
+ * @publicApi
+ */
+declare const LOCATION_UPGRADE_CONFIGURATION: InjectionToken<LocationUpgradeConfig>;
 /**
  * `NgModule` used for providing and configuring Angular's Unified Location Service for upgrading.
  *
@@ -352,99 +432,11 @@ export declare interface LocationUpgradeConfig {
  *
  * @publicApi
  */
-export declare class LocationUpgradeModule {
+declare class LocationUpgradeModule {
     static config(config?: LocationUpgradeConfig): ModuleWithProviders<LocationUpgradeModule>;
     static ɵfac: i0.ɵɵFactoryDeclaration<LocationUpgradeModule, never>;
     static ɵmod: i0.ɵɵNgModuleDeclaration<LocationUpgradeModule, never, [typeof i1.CommonModule], never>;
     static ɵinj: i0.ɵɵInjectorDeclaration<LocationUpgradeModule>;
 }
 
-
-/**
- * A codec for encoding and decoding URL parts.
- *
- * @publicApi
- **/
-export declare abstract class UrlCodec {
-    /**
-     * Encodes the path from the provided string
-     *
-     * @param path The path string
-     */
-    abstract encodePath(path: string): string;
-    /**
-     * Decodes the path from the provided string
-     *
-     * @param path The path string
-     */
-    abstract decodePath(path: string): string;
-    /**
-     * Encodes the search string from the provided string or object
-     *
-     * @param path The path string or object
-     */
-    abstract encodeSearch(search: string | {
-        [k: string]: unknown;
-    }): string;
-    /**
-     * Decodes the search objects from the provided string
-     *
-     * @param path The path string
-     */
-    abstract decodeSearch(search: string): {
-        [k: string]: unknown;
-    };
-    /**
-     * Encodes the hash from the provided string
-     *
-     * @param path The hash string
-     */
-    abstract encodeHash(hash: string): string;
-    /**
-     * Decodes the hash from the provided string
-     *
-     * @param path The hash string
-     */
-    abstract decodeHash(hash: string): string;
-    /**
-     * Normalizes the URL from the provided string
-     *
-     * @param path The URL string
-     */
-    abstract normalize(href: string): string;
-    /**
-     * Normalizes the URL from the provided string, search, hash, and base URL parameters
-     *
-     * @param path The URL path
-     * @param search The search object
-     * @param hash The has string
-     * @param baseUrl The base URL for the URL
-     */
-    abstract normalize(path: string, search: {
-        [k: string]: unknown;
-    }, hash: string, baseUrl?: string): string;
-    /**
-     * Checks whether the two strings are equal
-     * @param valA First string for comparison
-     * @param valB Second string for comparison
-     */
-    abstract areEqual(valA: string, valB: string): boolean;
-    /**
-     * Parses the URL string based on the base URL
-     *
-     * @param url The full URL string
-     * @param base The base for the URL
-     */
-    abstract parse(url: string, base?: string): {
-        href: string;
-        protocol: string;
-        host: string;
-        search: string;
-        hash: string;
-        hostname: string;
-        port: string;
-        pathname: string;
-    };
-}
-
-export { }
+export { $locationShim, $locationShimProvider, AngularJSUrlCodec, LOCATION_UPGRADE_CONFIGURATION, type LocationUpgradeConfig, LocationUpgradeModule, UrlCodec };