import type { Cookie, ClearCookiesOptions } from './types.js';
/**
 * Class to manipulate browser context cookies.
 *
 * @use when
 * - Authenticating your tests by injecting session cookies dynamically.
 *   (e.g., bypass login flows by adding a predefined authentication cookie).
 * - Verifying cookie behavior under different scenarios (e.g., verifying that a cookie gets
 *   correctly cleared or set by client-side operations).
 *
 * @dont use when
 * - Mocking HTTP requests or response headers; use the `network` fixture instead.
 */
export declare class Cookies {
    /**
     * Adds cookies to the browser context.
     *
     * @example
     * ```typescript
     * import { cookies } from '@pawel-up/lupa/commands'
     *
     * await cookies.add({
     *   name: 'session_id',
     *   value: 'abc123xyz',
     *   domain: 'localhost',
     *   path: '/'
     * })
     * ```
     */
    add(cookies: Cookie | Cookie[]): Promise<void>;
    /**
     * Gets all cookies from the browser context. Optionally filters by URLs.
     *
     * @example
     * ```typescript
     * import { cookies } from '@pawel-up/lupa/commands'
     *
     * const allCookies = await cookies.getAll()
     * const siteCookies = await cookies.getAll('https://example.com')
     * ```
     */
    getAll(urls?: string | string[]): Promise<Cookie[]>;
    /**
     * Clears cookies matching the options. If no options are specified, clears all cookies.
     *
     * @example
     * ```typescript
     * import { cookies } from '@pawel-up/lupa/commands'
     *
     * // Clear all cookies
     * await cookies.clear()
     *
     * // Clear a specific cookie by name
     * await cookies.clear({ name: 'session_id' })
     * ```
     */
    clear(options?: ClearCookiesOptions): Promise<void>;
}
export declare const cookies: Cookies;