ng-mocks 14.10.1 → 14.12.0

package/README.md

@@ -15,6 +15,7 @@ The current version of the library **has been tested** and **can be used** with:
 
 | Angular | ng-mocks | Jasmine | Jest | Ivy |
 | ------: | :------: | :-----: | :--: | :-: |
+|      17 |  latest  |   yes   | yes  | yes |
 |      16 |  latest  |   yes   | yes  | yes |
 |      15 |  latest  |   yes   | yes  | yes |
 |      14 |  latest  |   yes   | yes  | yes |
@@ -73,6 +74,8 @@ An example of a spec for a profile edit component.
 // cover behavior of the component.
 describe('profile:builder', () => {
   // Helps to reset customizations after each test.
+  // Alternatively, you can enable
+  // automatic resetting in test.ts.
   MockInstance.scope();
 
   // Let's configure TestBed via MockBuilder.

package/index.d.ts

@@ -303,7 +303,7 @@ export interface IMockBuilder extends Promise<IMockBuilderResult> {
 	 *
 	 * @see https://ng-mocks.sudo.eu/api/MockBuilder#provide
 	 */
-	provide(def: Provider): this;
+	provide(def: IMockBuilderProvider): this;
 	/**
 	 * .replace() lets substitute declarations.
 	 * For example, BrowserAnimationsModule with NoopAnimationsModule.
@@ -312,6 +312,21 @@ export interface IMockBuilder extends Promise<IMockBuilderResult> {
 	 */
 	replace(source: AnyType<any>, destination: AnyType<any>, config?: IMockBuilderConfigAll & IMockBuilderConfigModule): this;
 }
+/**
+ * IMockBuilderExtended
+ *
+ * @see https://ng-mocks.sudo.eu/api/MockBuilder#extending-mockbuilder
+ */
+export interface IMockBuilderExtended extends IMockBuilder {
+}
+/**
+ * IMockBuilderProvider
+ *
+ * A special type to cover providers including EnvironmentProviders.
+ */
+export type IMockBuilderProvider = Provider | {
+	ɵbrand: "EnvironmentProviders";
+};
 export type ngMocksMockConfig = {
 	config?: IMockBuilderConfig;
 	hostBindings?: string[];
@@ -1117,7 +1132,17 @@ export type MockBuilderParam = string | AnyDeclaration<any> | NgModuleWithProvid
  *
  * @see https://ng-mocks.sudo.eu/api/MockBuilder
  */
-export declare function MockBuilder(keepDeclaration?: MockBuilderParam | MockBuilderParam[] | null | undefined, itsModuleToMock?: MockBuilderParam | MockBuilderParam[] | null | undefined): IMockBuilder;
+export declare function MockBuilder(keepDeclaration?: MockBuilderParam | MockBuilderParam[] | null | undefined, itsModuleToMock?: MockBuilderParam | MockBuilderParam[] | null | undefined): IMockBuilderExtended;
+export declare namespace MockBuilder {
+	/**
+	 * Adds a custom function to MockBuilder
+	 */
+	function extend<K extends keyof IMockBuilderExtended & string>(func: K, callback: (builder: IMockBuilderExtended, parameters: never) => void): void;
+	/**
+	 * Removes a custom function from MockBuilder
+	 */
+	function extend<K extends keyof IMockBuilderExtended & string>(func: K): void;
+}
 /**
  * MockModule creates a mock module class out of an arbitrary module.
  * All declarations, imports, exports and providers will be mocked too.