/**
 * Computes the Z-Score for a given variable in an array of objects. By default, the function adds a new key `zScore` in each object, but you can change it by passing this option as the last parameter `{ newKey: "myNewKey" }`.
 *
 * @example
 * Basic example
 * ```js
 * // Let's say we have a data set like this.
 * const data = [
 *   { grade: 1 },
 *   { grade: 4 },
 *   { grade: 7 },
 *   { grade: 2 },
 *   { grade: 6 },
 * ]
 *
 * // We compute the Z-Score for the variable grade.
 * addZScore(data, "grade")
 *
 * // We now have the key zScore in the data.
 * // [
 * //  { grade: 1, zScore: -1.3155870289605438 },
 * //  { grade: 4, zScore: 0 },
 * //  { grade: 7, zScore: 1.3155870289605438 },
 * //  { grade: 2, zScore: -0.8770580193070292 },
 * //  { grade: 6, zScore: 0.8770580193070292 },
 * // ]
 *
 * // If you want a specific new key, use the options.
 * addZScore(data, "grade", { newKey: "zScoreGrade"})
 *
 * // We now have the key zScoreGrade in the data.
 * // [
 * //  { grade: 1, zScoreGrade: -1.3155870289605438 },
 * //  { grade: 4, zScoreGrade: 0 },
 * //  { grade: 7, zScoreGrade: 1.3155870289605438 },
 * //  { grade: 2, zScoreGrade: -0.8770580193070292 },
 * //  { grade: 6, zScoreGrade: 0.8770580193070292 },
 * // ]
 * ```
 *
 * @param data - The array of objects containing the data.
 * @param variable - The key of the variable to compute the Z-Score for.
 * @param options - Optional settings for the computation.
 * @param options.newKey - The key to use for the Z-Score. Default is "zScore".
 *
 * @category Statistics
 */
export default function addZScore(data: Record<string, unknown>[], variable: string, options?: {
    newKey?: string;
}): Record<string, unknown>[];