import type { Page } from '@playwright/test';
import type { ScreenConfig } from './screen-config.js';
interface StorageConfig {
    root: string;
}
interface GlobalConfig {
    storage?: StorageConfig;
    devtools?: boolean;
    page?: Page;
    /**
     * Move the mouse to a neutral corner before live OCR screenshots
     * (`waitFor`, `refresh`, locate). Clears hover highlights that break
     * template matching. Default: true.
     */
    unhoverBeforeCapture?: boolean;
    /**
     * Override the default unhover destination (top-left corner).
     * Useful when the top-left corner overlaps interactive content.
     */
    unhoverPoint?: {
        x: number;
        y: number;
    };
}
export declare function getGlobalConfig(): GlobalConfig;
/** Reset merged config (unit tests). */
export declare function resetGlobalConfig(): void;
/** Clear only the unhoverPoint from the global config (called by release()). */
export declare function clearConfigUnhoverPoint(): void;
/**
 * Configure storage root and optional devtools FAB.
 * Pass `page` to inject the FAB immediately (QA Wolf / non-fixture usage).
 * In fixture-based Playwright tests the FAB is injected automatically by the ocrScreen fixture.
 *
 * await configure({
 *   storage: { root: process.env.TEAM_STORAGE_DIR + '/screens' },
 *   devtools: true,
 *   page,
 *   // unhoverBeforeCapture: false, // keep hover for a rare case
 * });
 */
export declare function configure(config: GlobalConfig): Promise<void>;
/**
 * Take a screenshot of the current page and save it as blank.png
 * under {storage.root}/{name}/. Creates the directory if needed.
 */
export declare function saveScreen(page: Page, name: string): Promise<string>;
export declare function writeScreenBuffer(name: string, buffer: Buffer): string;
/**
 * Load a ScreenConfig by name from the configured storage root.
 * Reads {root}/{name}/index.json, blank.png, and templates/.
 */
export declare function loadScreen(name: string): ScreenConfig;
export {};
//# sourceMappingURL=configure.d.ts.map