import type { Suite, Test } from '@japa/runner/core';
import type { PluginConfig } from '../../types/main.js';
/**
 * Test setup hook that starts Playwright tracing for a test and stops
 * it based on the configured event ('onError' or 'onTest').
 *
 * Traces include screenshots, snapshots, and sources which can be
 * viewed in Playwright's trace viewer for debugging.
 *
 * @param tracingConfig - Tracing configuration from plugin config
 * @param test - The test instance to trace
 *
 * @example
 * ```ts
 * // Used internally by the plugin
 * test.setup((self) => traceActionsHook(tracingConfig, self))
 * ```
 */
export declare function traceActionsHook(tracingConfig: Exclude<PluginConfig['tracing'], undefined>, test: Test): Promise<(hasError: boolean) => Promise<void>>;
/**
 * Suite setup hook that cleans the traces output directory before
 * running tests in the suite.
 *
 * @param suite - The test suite instance
 * @param outputDirectory - The base directory for trace output
 *
 * @example
 * ```ts
 * // Used internally by the plugin
 * suite.setup(() => cleanTracesHook(suite, './traces'))
 * ```
 */
export declare function cleanTracesHook(suite: Suite, outputDirectory: string): Promise<void>;