/**
 * Parses a raw HTTP header block (a multi-line string of `"Name: Value"` lines)
 * into a key-value record with lower-cased header names.
 *
 * @param raw - The raw header block string. Each header occupies one line in the
 *   format `"Header-Name: header value"`. Lines are separated by `"\r\n"` or
 *   `"\n"`. An optional HTTP status line (e.g. `"HTTP/1.1 200 OK"`) at the
 *   start is silently ignored.
 * @returns A `Record<string, string>` mapping lower-cased header names to their
 *   trimmed values.
 *
 * @throws {Error} If raw is an empty string.
 *
 * @example
 * // Typical response header block
 * parseHTTPHeaders('Content-Type: application/json\r\nX-Request-Id: abc-123');
 * // { 'content-type': 'application/json', 'x-request-id': 'abc-123' }
 *
 * @example
 * // With an HTTP status line prefix
 * parseHTTPHeaders('HTTP/1.1 200 OK\r\nContent-Length: 42\r\nConnection: keep-alive');
 * // { 'content-length': '42', 'connection': 'keep-alive' }
 *
 * @example
 * // Headers separated by "\n" instead of "\r\n"
 * parseHTTPHeaders('Authorization: Bearer token\nAccept: application/json');
 * // { 'authorization': 'Bearer token', 'accept': 'application/json' }
 *
 * @example
 * // Multi-value folded headers (last value wins for duplicate names)
 * parseHTTPHeaders('Set-Cookie: a=1\r\nSet-Cookie: b=2');
 * // { 'set-cookie': 'b=2' }
 *
 * @note Header names are normalised to lowercase for case-insensitive access.
 * @note Duplicate header names are resolved by keeping the last occurrence.
 * @note Header folding (a deprecated RFC 7230 feature) is not supported.
 *
 * @complexity Time: O(n), Space: O(n) where n is the length of the raw string
 */
export declare function parseHTTPHeaders(raw: string): Record<string, string>;
//# sourceMappingURL=parseHTTPHeaders.d.ts.map