import type { EventEmitter } from 'node:events';

export interface ConsoleMessage {
	type(): string;
	text(): string;
	location(): { url: string };
}
export interface Route {
	request(): { url(): string; method(): string; headers(): Record<string, string>; resourceType(): string; postDataBuffer(): Buffer | null };
	fulfill( response: { status?: number; body?: string | Buffer; contentType?: string; headers?: Record<string, string> } ): Promise<void>;
	continue(): Promise<void>;
	abort( reason?: string ): Promise<void>;
}
interface Bounds { x: number; y: number; width: number; height: number }
interface Frame { url(): string; parentFrame(): null }
interface ScreenshotOptions { path?: string; type?: 'png'; timeout?: number; clip?: Bounds; omitBackground?: boolean }
interface NavigationOptions { timeout?: number; waitUntil?: string }
interface ContextOptions {
	gpu?: boolean;
	viewport?: { width: number; height: number };
	deviceScaleFactor?: number;
	/** Zero runs as fast as possible; use a display interval for pacing benchmarks. */
	frameIntervalMs?: number;
	recordVideo?: { dir: string; size?: { width: number; height: number } };
}

/** Native canvas rendering, Yoga layout, and Skia text measurement. */
export interface RendererLocator {
	screenshot( options?: ScreenshotOptions ): Promise<Buffer>;
	evaluateAll<R, A>( callback: ( elements: Element[], arg: A ) => R | Promise<R>, arg?: A ): Promise<R>;
	boundingBox(): Promise<Bounds | null>;
	nth( index: number ): RendererLocator;
	first(): RendererLocator;
}
export interface RendererPage extends EventEmitter<{
	console: [ ConsoleMessage ]; pageerror: [ Error ]; unhandledrejection: [ string ]; crash: []; close: []; framenavigated: [ Frame ];
}> {
	evaluate<R>( callback: () => R | Promise<R> ): Promise<R>;
	evaluate<R, A>( callback: ( arg: A ) => R | Promise<R>, arg: A ): Promise<R>;
	waitForFunction<A>( callback: string | ( ( arg: A ) => unknown ), arg?: A, options?: { timeout?: number; polling?: number | 'raf' } ): Promise<unknown>;
	goto( url: string, options?: NavigationOptions ): Promise<void>;
	reload( options?: NavigationOptions ): Promise<void>;
	screenshot( options?: ScreenshotOptions ): Promise<Buffer>;
	close(): Promise<void>;
	waitForTimeout( ms: number ): Promise<void>;
	waitForLoadState( state?: string, options?: { timeout?: number } ): Promise<void>;
	mainFrame(): Frame;
	url(): string;
	waitForURL( expected: string | RegExp | ( ( url: URL ) => boolean ), options?: { timeout?: number } ): Promise<void>;
	isClosed(): boolean;
	context(): RendererContext;
	locator( selector: string ): RendererLocator;
}
export interface RendererContext {
	/** `workers: true` also runs the script in every worker thread, which browsers never do. */
	addInitScript<A>( script: string | { content: string; workers?: boolean } | ( ( arg: A ) => unknown ), arg?: A ): Promise<void>;
	route( pattern: string, handler: ( route: Route ) => unknown ): Promise<void>;
	close(): Promise<void>;
	browser(): RendererBrowser;
	newPage(): Promise<RendererPage>;
}
export interface RendererBrowser extends EventEmitter<{ disconnected: [] }> {
	readonly execution: 'node';
	gpuInfo(): Promise<{ execution: 'node'; vendor: string; architecture: string; device: string; description: string; isFallbackAdapter: boolean }>;
	newContext( options?: ContextOptions ): Promise<RendererContext>;
	newPage( options?: ContextOptions ): Promise<RendererPage>;
	isConnected(): boolean;
	version(): string;
	close(): Promise<void>;
}
export function launchNodeRenderer(): Promise<RendererBrowser>;