ng-mocks 13.4.2 → 13.5.2

package/ng-mocks.d.ts

@@ -1,13 +1,14 @@
-import { ChangeDetectorRef, DebugElement, DebugNode, ElementRef, EventEmitter, FactoryProvider, InjectionToken, Injector, PipeTransform, Provider, TemplateRef, ViewContainerRef } from '@angular/core';
+import { ChangeDetectorRef, ClassProvider, DebugElement, DebugNode, ElementRef, EventEmitter, ExistingProvider, FactoryProvider, InjectionToken, Injector, PipeTransform, Provider, StaticClassProvider, TemplateRef, ValueProvider, ViewContainerRef } from '@angular/core';
 import { ComponentFixture, MetadataOverride, TestBed, TestModuleMetadata } from '@angular/core/testing';
 
-interface AbstractType<T> extends Function {
+declare type AbstractType<T> = Function & {
 	prototype: T;
-}
+};
 interface Type<T> extends Function {
 	new (...args: any[]): T;
 }
 declare type AnyType<T> = Type<T> | AbstractType<T>;
+declare type AnyDeclaration<T> = AnyType<T> | InjectionToken<T>;
 declare type DebugNodeSelector = DebugNode | ComponentFixture<any> | string | [
 	string
 ] | [
@@ -77,14 +78,14 @@ export declare const NG_MOCKS_ROOT_PROVIDERS: InjectionToken<void>;
  * @deprecated
  * @internal
  */
-export declare const getTestBedInjection: <I>(token: AnyType<I> | InjectionToken<I>) => I | undefined;
+export declare const getTestBedInjection: <I>(token: AnyDeclaration<I>) => I | undefined;
 /**
  * It will be removed from public interface with the next release: A14
  *
  * @deprecated
  * @internal
  */
-export declare const getInjection: <I>(token: Type<I> | InjectionToken<I>) => I;
+export declare const getInjection: <I>(token: AnyDeclaration<I>) => I;
 /**
  * The interface describes the type of the next value in MockBuilder().then().
  */
@@ -897,7 +898,7 @@ export declare const isNgInjectionToken: (token: any) => token is InjectionToken
  * MockInstance(ArbitraryService, 'enabled', () => false, 'get');
  * ```
  */
-export declare function MockInstance<T extends object, K extends keyof T, S extends () => T[K]>(instance: Type<T> | AbstractType<T>, name: K, stub: S, encapsulation: "get"): S;
+export declare function MockInstance<T extends object, K extends keyof T, S extends () => T[K]>(instance: AnyType<T>, name: K, stub: S, encapsulation: "get"): S;
 /**
  * This signature of MockInstance lets customize the setters of a property.
  *
@@ -911,7 +912,7 @@ export declare function MockInstance<T extends object, K extends keyof T, S exte
  * MockInstance(ArbitraryService, 'enabled', value => relServiceEnabled = value, 'set');
  * ```
  */
-export declare function MockInstance<T extends object, K extends keyof T, S extends (value: T[K]) => void>(instance: Type<T> | AbstractType<T>, name: K, stub: S, encapsulation: "set"): S;
+export declare function MockInstance<T extends object, K extends keyof T, S extends (value: T[K]) => void>(instance: AnyType<T>, name: K, stub: S, encapsulation: "set"): S;
 /**
  * This signature of MockInstance lets customize the properties and methods.
  *
@@ -924,7 +925,7 @@ export declare function MockInstance<T extends object, K extends keyof T, S exte
  * MockInstance(ArbitraryModule, 'currentUser', mockUser);
  * ```
  */
-export declare function MockInstance<T extends object, K extends keyof T, S extends T[K]>(instance: Type<T> | AbstractType<T>, name: K, stub: S): S;
+export declare function MockInstance<T extends object, K extends keyof T, S extends T[K]>(instance: AnyType<T>, name: K, stub: S): S;
 /**
  * This signature of MockInstance lets customize tokens with a callback.
  *
@@ -968,7 +969,7 @@ export declare function MockInstance<T>(declaration: InjectionToken<T>, config?:
  * });
  * ```
  */
-export declare function MockInstance<T>(declaration: Type<T> | AbstractType<T>, init?: (instance: T, injector: Injector | undefined) => void | Partial<T>): void;
+export declare function MockInstance<T>(declaration: AnyType<T>, init?: (instance: T, injector: Injector | undefined) => void | Partial<T>): void;
 /**
  * This signature of MockInstance lets customize the instances of mock classes with a callback.
  * You can return a shape or change the instance.
@@ -992,7 +993,7 @@ export declare function MockInstance<T>(declaration: Type<T> | AbstractType<T>,
  * });
  * ```
  */
-export declare function MockInstance<T>(declaration: Type<T> | AbstractType<T>, config?: {
+export declare function MockInstance<T>(declaration: AnyType<T>, config?: {
 	init?: (instance: T, injector: Injector | undefined) => void | Partial<T>;
 }): void;
 /**
@@ -1035,7 +1036,7 @@ interface NgModuleWithProviders<T = any> {
 	ngModule: Type<T>;
 	providers?: Provider[];
 }
-declare type MockBuilderParam = string | AnyType<any> | InjectionToken<any> | NgModuleWithProviders;
+declare type MockBuilderParam = string | AnyDeclaration<any> | NgModuleWithProviders;
 /**
  * MockBuilder provides reach and simple interfaces of chain functions
  * to build desired mock environment for tests.
@@ -1213,7 +1214,7 @@ export declare function MockDeclaration<T>(declaration: Type<T>): Type<MockedPip
  * });
  * ```
  */
-export declare function MockProviders(...providers: Array<AnyType<any> | InjectionToken<any>>): FactoryProvider[];
+export declare function MockProviders(...providers: Array<AnyDeclaration<any>>): FactoryProvider[];
 /**
  * MockProvider creates a mock provider out of passed an arbitrary service.
  *
@@ -1267,6 +1268,82 @@ export declare function MockProvider<I>(provider: InjectionToken<I>, useValue?:
  * ```
  */
 export declare function MockProvider<I = any>(provider: string, useValue?: Partial<I>): FactoryProvider;
+/**
+ * MockProvider generates useValue based on passed parameters.
+ *
+ * @see https://ng-mocks.sudo.eu/api/MockProvider#useValue
+ *
+ * ```ts
+ * TestBed.configureTestingModule({
+ *   providers: [
+ *     MockProvider(AuthService, {isLoggedIn: true}, 'useValue'),
+ *     MockProvider(APP_ROUTES, 5, 'useValue', true), // multi flag
+ *   ],
+ * });
+ * ```
+ */
+export declare function MockProvider<I>(provider: AnyDeclaration<I>, value: ValueProvider["useValue"], style: "useValue", multi?: ValueProvider["multi"]): ValueProvider;
+/**
+ * MockProvider generates useExisting based on passed parameters.
+ *
+ * @see https://ng-mocks.sudo.eu/api/MockProvider#useExisting
+ *
+ * ```ts
+ * TestBed.configureTestingModule({
+ *   providers: [
+ *     MockProvider(AuthService, MockAuthService, 'useExisting', true),
+ *     MockProvider(APP_ROUTES, MOCK_ROUTES, 'useExisting', true), // multi flag
+ *   ],
+ * });
+ * ```
+ */
+export declare function MockProvider<I>(provider: AnyDeclaration<I>, value: ExistingProvider["useExisting"], style: "useExisting", multi?: ExistingProvider["multi"]): ExistingProvider;
+/**
+ * MockProvider generates useClass based on passed parameters.
+ *
+ * @see https://ng-mocks.sudo.eu/api/MockProvider#useClass
+ *
+ * ```ts
+ * TestBed.configureTestingModule({
+ *   providers: [
+ *     MockProvider(AuthService, MockAuthService, 'useClass', [ctorDep1, ctorDep2]),
+ *     MockProvider(UserService, MockUserService, 'useClass', {
+ *       multi: true, // multi flag
+ *       deps: [ctorDep1, ctorDep2],
+ *     }),
+ *   ],
+ * });
+ * ```
+ */
+export declare function MockProvider<I>(provider: AnyDeclaration<I>, value: StaticClassProvider["useClass"], style: "useClass", multiDeps?: StaticClassProvider["multi"] | StaticClassProvider["deps"] | {
+	multi?: StaticClassProvider["multi"];
+	deps?: StaticClassProvider["deps"];
+}): ClassProvider;
+/**
+ * MockProvider generates useFactory based on passed parameters.
+ *
+ * @see https://ng-mocks.sudo.eu/api/MockProvider#useFactory
+ *
+ * ```ts
+ * TestBed.configureTestingModule({
+ *   providers: [
+ *     MockProvider(AuthService, (dep1, dep2) => {
+ *       // ...
+ *     }, 'useFactory', [ctorDep1, ctorDep2]),
+ *     MockProvider(UserService, (dep1, dep2) => {
+ *       // ...
+ *     }, 'useFactory', {
+ *       multi: true, // multi flag
+ *       deps: [ctorDep1, ctorDep2],
+ *     }),
+ *   ],
+ * });
+ * ```
+ */
+export declare function MockProvider<I>(provider: AnyDeclaration<I>, value: FactoryProvider["useFactory"], style: "useFactory", multiDeps?: FactoryProvider["multi"] | FactoryProvider["deps"] | {
+	multi?: FactoryProvider["multi"];
+	deps?: FactoryProvider["deps"];
+}): FactoryProvider;
 /**
  * MockService creates a mock instance out of an object or a class.
  * Primitives are converted to undefined.
@@ -1426,7 +1503,7 @@ export declare const ngMocks: {
 	 *
 	 * @see https://ng-mocks.sudo.eu/api/ngMocks/defaultConfig
 	 */
-	defaultConfig<T>(token: string | InjectionToken<T> | AnyType<T>, config?: IMockBuilderConfig): void;
+	defaultConfig<T>(token: string | AnyDeclaration<T>, config?: IMockBuilderConfig): void;
 	/**
 	 * ngMocks.defaultMock sets default customizations of mock tokens.
 	 * It helps to avoid repetitions from test to test.
@@ -1454,7 +1531,7 @@ export declare const ngMocks: {
 	 *
 	 * @see https://ng-mocks.sudo.eu/api/ngMocks/defaultMock
 	 */
-	defaultMock<T = any>(defs: Array<AnyType<T> | InjectionToken<T>>, handler?: (value: undefined | T, injector: Injector) => undefined | Partial<T>, config?: IMockBuilderConfig): void;
+	defaultMock<T = any>(defs: Array<AnyDeclaration<T>>, handler?: (value: undefined | T, injector: Injector) => undefined | Partial<T>, config?: IMockBuilderConfig): void;
 	/**
 	 * ngMocks.globalExclude configures which declarations, providers and tokens
 	 * should be excluded from mocks.
@@ -1465,7 +1542,7 @@ export declare const ngMocks: {
 	 * ngMocks.globalExclude(TranslationModule);
 	 * ```
 	 */
-	globalExclude(source: AnyType<any> | InjectionToken<any>): void;
+	globalExclude(source: AnyDeclaration<any>): void;
 	/**
 	 * ngMocks.globalKeep configures which declarations, providers and tokens
 	 * should not be mocked and will stay as they are in mocks.
@@ -1476,7 +1553,7 @@ export declare const ngMocks: {
 	 * ngMocks.globalKeep(TranslationModule);
 	 * ```
 	 */
-	globalKeep(source: AnyType<any> | InjectionToken<any>): void;
+	globalKeep(source: AnyDeclaration<any>): void;
 	/**
 	 * ngMocks.globalMock configures which declarations, providers and tokens
 	 * should be mocked in kept declarations.
@@ -1487,7 +1564,7 @@ export declare const ngMocks: {
 	 * ngMocks.globalMock(TranslationModule);
 	 * ```
 	 */
-	globalMock(source: AnyType<any> | InjectionToken<any>): void;
+	globalMock(source: AnyDeclaration<any>): void;
 	/**
 	 * ngMocks.globalReplace configures which declarations, providers and tokens
 	 * should be substituted in mocks.
@@ -1509,7 +1586,7 @@ export declare const ngMocks: {
 	 * ngMocks.globalWipe(BrowserAnimationsModule);
 	 * ```
 	 */
-	globalWipe(source: AnyType<any> | InjectionToken<any>): void;
+	globalWipe(source: AnyDeclaration<any>): void;
 	/**
 	 * ngMocks.change triggers ControlValueAccessor update.
 	 *
@@ -1982,7 +2059,7 @@ export declare const ngMocks: {
 	 * const myDirective = ngMocks.get('my-component', MyDirective);
 	 * ```
 	 */
-	get<T>(elSelector: DebugNodeSelector, provider: AnyType<T> | InjectionToken<T>): T;
+	get<T>(elSelector: DebugNodeSelector, provider: AnyDeclaration<T>): T;
 	/**
 	 * ngMocks.get tries to get an instance of declaration, provider or token
 	 * from the element which is matching a selector, otherwise the notFoundValue.
@@ -1994,7 +2071,7 @@ export declare const ngMocks: {
 	 * const myDirective = ngMocks.get('my-component', MyDirective, null);
 	 * ```
 	 */
-	get<T, D>(elSelector: DebugNodeSelector, provider: AnyType<T> | InjectionToken<T>, notFoundValue: D): D | T;
+	get<T, D>(elSelector: DebugNodeSelector, provider: AnyDeclaration<T>, notFoundValue: D): D | T;
 	/**
 	 * ngMocks.findInstance searches for an instance of declaration, provider or token,
 	 * and returns the first one.
@@ -2007,7 +2084,7 @@ export declare const ngMocks: {
 	 * const config = ngMocks.findInstance(APP_CONFIG);
 	 * ```
 	 */
-	findInstance<T>(instanceClass: AnyType<T> | InjectionToken<T>): T;
+	findInstance<T>(instanceClass: AnyDeclaration<T>): T;
 	/**
 	 * ngMocks.findInstance searches for an instance of declaration, provider or token
 	 * starting from an element, and returns the first one.
@@ -2020,7 +2097,7 @@ export declare const ngMocks: {
 	 * const config = ngMocks.findInstance(debugElement, APP_CONFIG);
 	 * ```
 	 */
-	findInstance<T>(elSelector: DebugNodeSelector, instanceClass: AnyType<T> | InjectionToken<T>): T;
+	findInstance<T>(elSelector: DebugNodeSelector, instanceClass: AnyDeclaration<T>): T;
 	/**
 	 * ngMocks.findInstance searches for an instance of declaration, provider or token,
 	 * and returns the first one, otherwise the notFoundValue.
@@ -2032,7 +2109,7 @@ export declare const ngMocks: {
 	 * const service = ngMocks.findInstance(AuthService, null);
 	 * const config = ngMocks.findInstance(APP_CONFIG, false);
 	 */
-	findInstance<T, D>(instanceClass: AnyType<T> | InjectionToken<T>, notFoundValue: D): D | T;
+	findInstance<T, D>(instanceClass: AnyDeclaration<T>, notFoundValue: D): D | T;
 	/**
 	 * ngMocks.findInstance searches for an instance of declaration, provider or token
 	 * starting from an element, and returns the first one, otherwise the notFoundValue.
@@ -2045,7 +2122,7 @@ export declare const ngMocks: {
 	 * const config = ngMocks.findInstance(debugElement, APP_CONFIG, false);
 	 * ```
 	 */
-	findInstance<T, D>(elSelector: DebugNodeSelector, instanceClass: AnyType<T> | InjectionToken<T>, notFoundValue: D): D | T;
+	findInstance<T, D>(elSelector: DebugNodeSelector, instanceClass: AnyDeclaration<T>, notFoundValue: D): D | T;
 	/**
 	 * ngMocks.findInstances searches for all instances of declaration, provider or token,
 	 * and returns an array of them.
@@ -2058,7 +2135,7 @@ export declare const ngMocks: {
 	 * const configs = ngMocks.findInstances(APP_CONFIG);
 	 * ```
 	 */
-	findInstances<T>(instanceClass: AnyType<T> | InjectionToken<T>): T[];
+	findInstances<T>(instanceClass: AnyDeclaration<T>): T[];
 	/**
 	 * ngMocks.findInstances searches for all instances of declaration, provider or token
 	 * starting from an element, and returns an array of them.
@@ -2071,7 +2148,7 @@ export declare const ngMocks: {
 	 * const configs = ngMocks.findInstances(debugElement, APP_CONFIG);
 	 * ```
 	 */
-	findInstances<T>(elSelector: DebugNodeSelector, instanceClass: AnyType<T> | InjectionToken<T>): T[];
+	findInstances<T>(elSelector: DebugNodeSelector, instanceClass: AnyDeclaration<T>): T[];
 	/**
 	 * ngMocks.findTemplateRef searches for a TemplateRef which is matching the selector,
 	 * and returns the first found, otherwise the notFoundValue.
@@ -2245,7 +2322,7 @@ export declare const ngMocks: {
 	 *
 	 * @see https://ng-mocks.sudo.eu/api/ngMocks/guts
 	 */
-	guts(keep: AnyType<any> | InjectionToken<any> | Provider | Array<AnyType<any> | InjectionToken<any> | Provider> | null | undefined, mock?: AnyType<any> | InjectionToken<any> | NgModuleWithProviders | Provider | Array<AnyType<any> | InjectionToken<any> | NgModuleWithProviders | Provider> | null | undefined, exclude?: AnyType<any> | InjectionToken<any> | Array<AnyType<any> | InjectionToken<any>> | null | undefined): TestModuleMetadata;
+	guts(keep: AnyDeclaration<any> | Provider | Array<AnyDeclaration<any> | Provider> | null | undefined, mock?: AnyDeclaration<any> | NgModuleWithProviders | Provider | Array<AnyDeclaration<any> | NgModuleWithProviders | Provider> | null | undefined, exclude?: AnyDeclaration<any> | Array<AnyDeclaration<any>> | null | undefined): TestModuleMetadata;
 	/**
 	 * ngMocks.faster lets reuse the same TestBed between tests instead of resetting it.
 	 *
@@ -2331,6 +2408,12 @@ export declare const ngMocks: {
 		onTestBedFlushNeed?: "throw" | "warn" | "i-know-but-disable" | null;
 	}): void;
 };
+/**
+ * This signature of MockRender lets create an empty fixture.
+ *
+ * @see https://ng-mocks.sudo.eu/api/MockRender
+ */
+export declare function MockRender(): MockedComponentFixture<void, void>;
 /**
  * This signature of MockRender lets create a fixture to access a token.
  *
@@ -2361,14 +2444,6 @@ export declare function MockRender<MComponent, TComponent extends object = Recor
  * @see https://ng-mocks.sudo.eu/api/MockRender
  */
 export declare function MockRender<MComponent>(template: AnyType<MComponent>): MockedComponentFixture<MComponent, MComponent>;
-/**
- * This signature of MockRender with an empty template does not have the point.
- *
- * @see https://ng-mocks.sudo.eu/api/MockRender
- */
-export declare function MockRender(template: ""): ComponentFixture<void> & {
-	point: undefined;
-};
 /**
  * This signature of MockRender without params should not autocomplete any keys of any types.
  *

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ng-mocks",
-  "version": "13.4.2",
+  "version": "13.5.2",
   "description": "An Angular testing library for creating mock services, components, directives, pipes and modules in unit tests, which includes shallow rendering, precise stubs to dump child dependencies, supports Angular 5 6 7 8 9 10 11 12 13, jasmine and jest.",
   "keywords": [
     "angular",