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

package/static/testing/index.d.ts

@@ -1,43 +1,39 @@
 /**
- * @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 { Type } from '@angular/core';
 
-
 /**
- * A helper function to use when unit testing AngularJS services that depend upon downgraded Angular
+ * A helper function to use when unit testing Angular services that depend upon upgraded AngularJS
  * services.
  *
- * This function returns an AngularJS module that is configured to wire up the AngularJS and Angular
- * injectors without the need to actually bootstrap a hybrid application.
+ * This function returns an `NgModule` decorated class that is configured to wire up the Angular
+ * and AngularJS injectors without the need to actually bootstrap a hybrid application.
  * This makes it simpler and faster to unit test services.
  *
- * Use the returned AngularJS module in a call to
- * [`angular.mocks.module`](https://docs.angularjs.org/api/ngMock/function/angular.mock.module) to
- * include this module in the unit test injector.
+ * Use the returned class as an "import" when configuring the `TestBed`.
  *
- * In the following code snippet, we are configuring the `$injector` with two modules:
- * The AngularJS `ng1AppModule`, which is the AngularJS part of our hybrid application and the
- * `Ng2AppModule`, which is the Angular part.
+ * In the following code snippet, we are configuring the TestBed with two imports.
+ * The `Ng2AppModule` is the Angular part of our hybrid application and the `ng1AppModule` is the
+ * AngularJS part.
  *
- * {@example upgrade/static/ts/full/module.spec.ts region='angularjs-setup'}
+ * {@example upgrade/static/ts/full/module.spec.ts region='angular-setup'}
  *
- * Once this is done we can get hold of services via the AngularJS `$injector` as normal.
- * Services that are (or have dependencies on) a downgraded Angular service, will be instantiated as
- * needed by the Angular root `Injector`.
+ * Once this is done we can get hold of services via the Angular `Injector` as normal.
+ * Services that are (or have dependencies on) an upgraded AngularJS service, will be instantiated
+ * as needed by the AngularJS `$injector`.
  *
- * In the following code snippet, `heroesService` is a downgraded Angular service that we are
- * accessing from AngularJS.
+ * In the following code snippet, `HeroesService` is an Angular service that depends upon an
+ * AngularJS service, `titleCase`.
  *
- * {@example upgrade/static/ts/full/module.spec.ts region='angularjs-spec'}
+ * {@example upgrade/static/ts/full/module.spec.ts region='angular-spec'}
  *
  * <div class="docs-alert docs-alert-important">
  *
- * This helper is for testing services not components.
+ * This helper is for testing services not Components.
  * For Component testing you must still bootstrap a hybrid app. See `UpgradeModule` or
  * `downgradeModule` for more information.
  *
@@ -56,7 +52,7 @@ import { Type } from '@angular/core';
  * The helper sets up global variables to hold the shared Angular and AngularJS injectors.
  *
  * * Only call this helper once per spec.
- * * Do not use `createAngularJSTestingModule` in the same spec as `createAngularTestingModule`.
+ * * Do not use `createAngularTestingModule` in the same spec as `createAngularJSTestingModule`.
  *
  * </div>
  *
@@ -69,40 +65,44 @@ import { Type } from '@angular/core';
  * </code-tabs>
  *
  *
- * @param angularModules a collection of Angular modules to include in the configuration.
+ * @param angularJSModules a collection of the names of AngularJS modules to include in the
+ * configuration.
+ * @param [strictDi] whether the AngularJS injector should have `strictDI` enabled.
  *
  * @publicApi
  */
-export declare function createAngularJSTestingModule(angularModules: any[]): string;
+declare function createAngularTestingModule(angularJSModules: string[], strictDi?: boolean): Type<any>;
 
 /**
- * A helper function to use when unit testing Angular services that depend upon upgraded AngularJS
+ * A helper function to use when unit testing AngularJS services that depend upon downgraded Angular
  * services.
  *
- * This function returns an `NgModule` decorated class that is configured to wire up the Angular
- * and AngularJS injectors without the need to actually bootstrap a hybrid application.
+ * This function returns an AngularJS module that is configured to wire up the AngularJS and Angular
+ * injectors without the need to actually bootstrap a hybrid application.
  * This makes it simpler and faster to unit test services.
  *
- * Use the returned class as an "import" when configuring the `TestBed`.
+ * Use the returned AngularJS module in a call to
+ * [`angular.mocks.module`](https://docs.angularjs.org/api/ngMock/function/angular.mock.module) to
+ * include this module in the unit test injector.
  *
- * In the following code snippet, we are configuring the TestBed with two imports.
- * The `Ng2AppModule` is the Angular part of our hybrid application and the `ng1AppModule` is the
- * AngularJS part.
+ * In the following code snippet, we are configuring the `$injector` with two modules:
+ * The AngularJS `ng1AppModule`, which is the AngularJS part of our hybrid application and the
+ * `Ng2AppModule`, which is the Angular part.
  *
- * {@example upgrade/static/ts/full/module.spec.ts region='angular-setup'}
+ * {@example upgrade/static/ts/full/module.spec.ts region='angularjs-setup'}
  *
- * Once this is done we can get hold of services via the Angular `Injector` as normal.
- * Services that are (or have dependencies on) an upgraded AngularJS service, will be instantiated
- * as needed by the AngularJS `$injector`.
+ * Once this is done we can get hold of services via the AngularJS `$injector` as normal.
+ * Services that are (or have dependencies on) a downgraded Angular service, will be instantiated as
+ * needed by the Angular root `Injector`.
  *
- * In the following code snippet, `HeroesService` is an Angular service that depends upon an
- * AngularJS service, `titleCase`.
+ * In the following code snippet, `heroesService` is a downgraded Angular service that we are
+ * accessing from AngularJS.
  *
- * {@example upgrade/static/ts/full/module.spec.ts region='angular-spec'}
+ * {@example upgrade/static/ts/full/module.spec.ts region='angularjs-spec'}
  *
  * <div class="docs-alert docs-alert-important">
  *
- * This helper is for testing services not Components.
+ * This helper is for testing services not components.
  * For Component testing you must still bootstrap a hybrid app. See `UpgradeModule` or
  * `downgradeModule` for more information.
  *
@@ -121,7 +121,7 @@ export declare function createAngularJSTestingModule(angularModules: any[]): str
  * The helper sets up global variables to hold the shared Angular and AngularJS injectors.
  *
  * * Only call this helper once per spec.
- * * Do not use `createAngularTestingModule` in the same spec as `createAngularJSTestingModule`.
+ * * Do not use `createAngularJSTestingModule` in the same spec as `createAngularTestingModule`.
  *
  * </div>
  *
@@ -134,12 +134,10 @@ export declare function createAngularJSTestingModule(angularModules: any[]): str
  * </code-tabs>
  *
  *
- * @param angularJSModules a collection of the names of AngularJS modules to include in the
- * configuration.
- * @param [strictDi] whether the AngularJS injector should have `strictDI` enabled.
+ * @param angularModules a collection of Angular modules to include in the configuration.
  *
  * @publicApi
  */
-export declare function createAngularTestingModule(angularJSModules: string[], strictDi?: boolean): Type<any>;
+declare function createAngularJSTestingModule(angularModules: any[]): string;
 
-export { }
+export { createAngularJSTestingModule, createAngularTestingModule };