/**
 * @file 向量（数组）计算工具函数
 */
/**
 * 计算两个向量的点积（Dot Product）。
 * @param vecA - 向量 A。
 * @param vecB - 向量 B。
 * @returns 向量 A 和 B 的点积。
 * @throws 如果向量长度不一致，则抛出错误。
 */
export declare function dotProduct(vecA: number[], vecB: number[]): number;
/**
 * 计算向量的模（Magnitude/L2 Norm）。
 * @param vec - 向量。
 * @returns 向量的模。
 */
export declare function magnitude(vec: number[]): number;
/**
 * 计算两个向量之间的余弦相似度。
 * 返回值范围为 -1 到 1，值越接近 1 表示两个向量越相似。
 * @param vecA - 向量 A (number[]).
 * @param vecB - 向量 B (number[]).
 * @returns 两个向量的余弦相似度。
 * @throws 如果向量长度不一致，则抛出错误。
 */
export declare function cosineSimilarity(vecA: number[], vecB: number[]): number;
/**
 * 计算两个向量的欧氏距离。
 * @param vecA - 向量 A。
 * @param vecB - 向量 B。
 * @returns 两个向量之间的欧氏距离。
 * @throws 如果向量长度不一致，则抛出错误。
 */
export declare function euclideanDistance(vecA: number[], vecB: number[]): number;
/**
 * 向量加法。
 * @param vecA - 向量 A。
 * @param vecB - 向量 B。
 * @returns 两个向量相加得到的新向量。
 * @throws 如果向量长度不一致，则抛出错误。
 */
export declare function add(vecA: number[], vecB: number[]): number[];
/**
 * 向量减法。
 * @param vecA - 向量 A。
 * @param vecB - 向量 B。
 * @returns 向量 A 减去向量 B 得到的新向量。
 * @throws 如果向量长度不一致，则抛出错误。
 */
export declare function subtract(vecA: number[], vecB: number[]): number[];