import Mocha = require("mocha");
import { AftTest, AftTestFunction, AftTestOptions, Func, TestResult, TestStatus } from "aft-core";
/**
 * expects to be passed the scope from an executing Mocha
 * test (i.e. the `this` argument)
 * > **NOTE:**
 * >
 * > the Mocha `this` scope is only available when tests
 * are written using
 * >
 * > `it('description', function() {...})`
 * >
 * > and _not_ when using
 * >
 * > `it('description', () => {...})`
 * >
 * @param scope the `this` scope from within a Mocha `it`
 */
export declare class AftMochaTest extends AftTest {
    /**
     * an instance of a `Mocha.Test` from the `this` scope
     * from within a Mocha `it` function taken from
     * `this.test`
     * #### NOTE:
     * > if using an arrow function in your `it`
     * this will not be set
     */
    readonly test: Mocha.Test;
    /**
     * expects to be passed the scope from an executing Mocha
     * test (i.e. the `this` argument)
     * #### NOTE:
     * > the Mocha `this` scope is only available when tests
     * are written using
     * >
     * > `it('description', function() {...})`
     * >
     * > and _not_ when using
     * >
     * > `it('description', () => {...})`
     * >
     * @param scope the `this` scope from within a Mocha `it`
     */
    constructor(scope?: any, testFunction?: AftTestFunction, options?: AftTestOptions);
    protected _generateTestResult(status: TestStatus, resultMessage: string, testId?: string): Promise<TestResult>;
}
/**
 * creates a new `AftMochaTest` instace to be used for executing some Functional
 * Test Assertion and calls the `run` function to execute the `testFunction`.
 *
 * ex:
 * ```typescript
 * it('[C1234] example usage for AftTest', async function() {
 *     await aftMochaTest(this, async (v: AftMochaTest) => {
 *        await v.reporter.info('doing some testing...');
 *        const feature = new FeatureObj();
 *        await v.verify(() => feature.returnExpectedValueAsync(), equaling('expected value'));
 *     }); // if PolicyManager.shouldRun('C1234') returns `false` the assertion is not run
 * })
 * ```
 * @param context a `this` representing the current `Mocha.Context` containing the
 * `Mocha.Test` used to get the test description or a `string` description
 * @param testFunction the `Func<AftMochaTest, void | PromiseLike<void>>` function to be
 * executed by this `AftMochaTest`
 * @param options an optional `AftTestOptions` object containing overrides to internal
 * configuration and settings
 * @returns an async `Promise<void>` that runs the passed in `testFunction`
 */
export declare const aftMochaTest: (context: Mocha.Context | string, testFunction: Func<AftMochaTest, void | PromiseLike<void>>, options?: AftTestOptions) => Promise<AftMochaTest>;