import type { Cookie } from './types.ts';
/**
 * RFC 6265 §5.4 — Build the candidate cookie list for an outgoing request.
 *
 * Returns all cookies from `cookies` that match the request URL,
 * filtered by domain, path, expiry, secure, and httpOnly rules.
 *
 * Does NOT mutate lastAccessTime — the jar handles that on retrieval.
 */
export declare function getMatchingCookies(cookies: Cookie[], requestUrl: URL, isHttpApi?: boolean): Cookie[];
/**
 * RFC 6265 §5.4 — Serialize a list of matching cookies into a Cookie header value.
 *
 * Sorts by: longer path first, then earlier creationTime first.
 * Joins with "; " (semicolon + space).
 *
 * @example
 *     serializeCookies([...]) // → 'session=abc123; token=xyz'
 */
export declare function serializeCookies(cookies: Cookie[]): string;