/// <reference types="jest" />
import { Type } from '@automock/types';
import { IdentifierMetadata } from '@automock/common';
export * from './testbed-factory';
declare module '@automock/core' {
    /**
     * Provides a reference to mock objects that have been mocked for testing
     * purposes within the test environment.
     *
     * Augmentation of the `@automock/core` module for the `StubbedInstance` type.
     * In this context, the `StubbedInstance` type is replaced by `jest.Mocked`.
     *
     * Essentially, when you retrieve an instance using this interface, you're not getting
     * the original instance but a Jest-mocked version of it, allowing for enhanced testing
     * capabilities like spying on method calls, faking return values, and more.
     *
     * @see https://automock.dev/api-reference/api/unitreference-api
     */
    interface UnitReference {
        /**
         * Retrieves a reference to the mocked object of a dependency corresponding to its type
         * identifier.
         *
         * @template TDependency The type of the dependency being retrieved.
         * @param type The type representing the dependency.
         * @returns The mocked object corresponding to the provided type identifier.
         */
        get<TDependency>(type: Type<TDependency>): jest.Mocked<TDependency>;
        /**
         * Retrieves a reference to the mocked object of a dependency corresponding to its
         * type identifier and the identifier metadata.
         *
         * @since 2.1.0
         * @template TDependency The type of the dependency being retrieved.
         * @param type The type representing the dependency
         * @param identifierMetadata An accompanying metadata object for the token identifier.
         * @returns jest.Mocked<TDependency> The mocked object corresponding to the provided
         * type identifier and identifier metadata.
         */
        get<TDependency>(type: Type<TDependency>, identifierMetadata: IdentifierMetadata): jest.Mocked<TDependency>;
        /**
         * Retrieves a reference to the mocked object of a dependency corresponding to a string-based
         * token.
         *
         * @template TDependency The type of the dependency being retrieved.
         * @param token The string-based token representing the dependency.
         * @returns jest.Mocked<TDependency> The mocked object corresponding to the provided
         * string-based token.
         */
        get<TDependency>(token: string): jest.Mocked<TDependency>;
        /**
         * Retrieves a reference to the mocked object of a dependency corresponding to its
         * string-based identifier and the identifier metadata.
         *
         * @since 2.1.0
         * @template TDependency The type of the dependency being retrieved.
         * @param token The string-based token representing the dependency.
         * @param identifierMetadata An accompanying metadata object for the token identifier.
         * @returns jest.Mocked<TDependency> The mocked object corresponding to the provided
         * string-based token and identifier metadata.
         */
        get<TDependency>(token: string, identifierMetadata: IdentifierMetadata): jest.Mocked<TDependency>;
        /**
         * Retrieves a reference to the mocked object of a dependency corresponding to a symbol-based
         * token.
         *
         * @since 2.0.0
         * @template TDependency The type of the dependency being retrieved.
         * @param token The symbol-based token representing the dependency.
         * @returns jest.Mocked<TDependency> The mocked object corresponding to the provided
         * symbol-based token.
         */
        get<TDependency>(token: symbol): jest.Mocked<TDependency>;
        /**
         * Retrieves a reference to the mocked object of a dependency corresponding to its
         * symbol-based identifier and the identifier metadata.
         *
         * @since 2.1.0
         * @template TDependency The type of the dependency being retrieved.
         * @param token The symbol-based token representing the dependency.
         * @param identifierMetadata An accompanying metadata object for the token identifier.
         * @returns jest.Mocked<TDependency> The mocked object corresponding to the provided
         * symbol-based token and identifier metadata.
         */
        get<TDependency>(token: symbol, identifierMetadata: IdentifierMetadata): jest.Mocked<TDependency>;
        /**
         * Retrieves a reference to the mocked object of a dependency corresponding to its
         * type, string-based or symbol-based identifier and the identifier metadata if present.
         *
         * This method provides flexibility in retrieving dependencies by allowing various identifier
         * types.
         *
         * @since 2.1.0
         * @template TDependency The type of the dependency being retrieved.
         * @param identifier The type or token that the dependency corresponds to.
         * @param identifierMetadata
         * @returns jest.Mocked<TDependency> The mocked object corresponding to the provided
         * identifier, along with any available identifier metadata.
         */
        get<TDependency>(identifier: Type<TDependency> | string | symbol, identifierMetadata?: IdentifierMetadata): jest.Mocked<TDependency>;
    }
}