/**
 * Sanitizes a string to be safe for use in filenames.
 * Removes special characters and normalizes whitespace and hyphens.
 *
 * @param str - The string to sanitize (e.g., test suite or test name)
 * @returns {string} Sanitized string safe for filesystem use
 */
export declare function sanitizeForFilename(str: string): string;
/**
 * Builds a standardized filename for test artifacts (e.g., screenshots, traces).
 * Combines test name, state, and attempt number into a readable filename.
 *
 * @param testName - The name of the test (will be sanitized)
 * @param state - The test state (e.g., 'passed', 'failed')
 * @param currentRetry - The current retry attempt number (0-based)
 * @returns {string} A sanitized filename in the format: "testName (state) (attempt N)"
 */
export declare function fileNameBuilder(testName: string, state: string, currentRetry?: number): string;