import { Page } from 'playwright';
import { RendererOptions, FFmpegConfig } from '../types.js';
export interface RenderStrategy {
    /**
     * Optional setup before the page navigates, e.g. init scripts that must run before the
     * page's own scripts.
     * @param page The Playwright page instance.
     */
    init?(page: Page): Promise<void>;
    /**
     * Prepares the strategy for rendering.
     * This method is called once before the capture loop begins.
     * Useful for initializing encoders, setting up event listeners, or other stateful setup.
     * @param page The Playwright page instance.
     */
    prepare(page: Page): Promise<void>;
    /**
     * Runs diagnostics to verify the environment capabilities required by this strategy.
     * Should return a JSON object with findings.
     * @param page The Playwright page instance.
     */
    diagnose(page: Page): Promise<any>;
    /**
     * Captures a single frame at the specified time.
     * @param page The Playwright page instance.
     * @param frameTime The time in milliseconds to capture.
     * @returns A Promise that resolves to a Buffer containing the image data.
     */
    capture(page: Page, frameTime: number): Promise<any> | any;
    /**
     * Optional synchronous post-processing step for the capture result.
     */
    processCaptureResult?(rawResult: any): string | Buffer;
    /**
     * Finishes the rendering process.
     * This method is called after the capture loop ends.
     * Useful for flushing encoders or cleaning up resources.
     * @param page The Playwright page instance.
     * @returns A Promise that resolves to a Buffer containing any remaining data, or void.
     */
    finish(page: Page): Promise<Buffer | string | void>;
    /**
     * Returns the full FFmpeg arguments for this strategy.
     * These arguments describe both input and output configuration.
     * @param options Renderer options.
     * @param outputPath The path to the output file.
     */
    getFFmpegArgs(options: RendererOptions, outputPath: string): FFmpegConfig;
    /**
     * Cleans up any temporary resources created by the strategy.
     * This is called after the render process (including FFmpeg) has fully completed.
     */
    cleanup?(): Promise<void>;
}