/**
 * Header parsing utilities for CTRK files.
 */
import { BufferReader } from './buffer-reader.js';
import type { FinishLine } from './types.js';
/**
 * Validate CTRK file magic signature.
 *
 * @param data - The first 4 bytes of the file
 * @returns True if the magic is valid
 */
export declare function validateMagic(data: Uint8Array): boolean;
/**
 * Find the byte offset where the data section begins.
 *
 * The CTRK header contains variable-length entries starting at 0x34.
 * This function iterates through those entries to find where they end
 * and the data records begin.
 *
 * @param reader - BufferReader positioned at the start of the file
 * @returns Byte offset of the first data record (typically ~0xCB)
 */
export declare function findDataStart(reader: BufferReader): number;
/**
 * Extract finish line coordinates from CTRK file header.
 *
 * Searches for RECORDLINE.P1.LAT, P1.LNG, P2.LAT, and P2.LNG entries
 * in the header and parses their double-precision floating point values.
 *
 * @param data - Raw bytes from the CTRK file (at least first ~500 bytes)
 * @returns FinishLine object with parsed coordinates, or null if not found
 */
export declare function parseFinishLine(data: Uint8Array): FinishLine | null;
//# sourceMappingURL=header-parser.d.ts.map