/**
 * Calculates the cosine similarity between two numeric vectors.
 * * This implementation is safeguarded against zero-magnitudes (returns 0)
 * and ensures the result is clamped between -1 and 1 to account for
 * floating-point precision errors.
 *
 * @param a - The first vector array.
 * @param b - The second vector array.
 * @returns A similarity score from -1 (opposite) to 1 (identical).
 * @throws {Error} If the vectors have different lengths.
 */
export declare const cosineSimilarity: (a: number[], b: number[]) => number;